lucy-cli 1.1.1 → 1.2.0

package/README.md

@@ -42,16 +42,16 @@ Contribution are welcome, issue and pull request and I will merge it if i see it
 
 Lucy-CLI is designed to streamline the setup and management of TypeScript within Wix Velo projects, providing tools to enhance code quality and reduce development time. Here’s what it offers:
 
-1. **ESLint Configuration**  
+1.  **ESLint Configuration**
    - Adds ESLint with a default configuration (customizable post-init) to maintain consistent code style and prevent common errors.
 
-2. **Wix Type Definitions**  
+2.  **Wix Type Definitions**
    - Exposes Wix type definitions located in `.wix/types/wix-code-types`, allowing direct import and access to the types for comprehensive TypeScript support.
 
-3. **Autocomplete and Type Mapping for Page Elements**  
+3.  **Autocomplete and Type Mapping for Page Elements**
    - Maps Wix page elements to their respective types, so `$w('element')` calls have full TypeScript support, including autocomplete for properties and methods.
 
-4. **Git Submodule Support**  
+4.  **Git Submodule Support**
    - Includes support for git submodules, providing full type support within submodules and enabling the use of libraries and types across projects.
    - To add a submodule, include the following in the `lucy.json` file:
 
@@ -64,37 +64,43 @@ Lucy-CLI is designed to streamline the setup and management of TypeScript within
       }
       ```
 
-1. **Configurable Setup**  
+5.  **Configurable Setup**
    - After initialization, Lucy-CLI creates a `lucy-config.json` configuration file where you can modify settings, add dev packages, specify Wix packages, and configure git submodules.
 
-2. **Execute render functions**  
+6.  **Execute render functions**
    - Lucy-CLI can execute render functions located in the backend template folder, allowing you to test render functions locally.
 
-3. **compile sccs files**  
-   - Lucy-CLI can compile scss files to css files.
+-7.  **Compile SCSS files**
+   - Lucy-CLI can compile SCSS files to CSS files.
    - It compiles styles/global.scss file to global.css.
 
-4. **Wix NPM Package Installation**
-   - Lucy-CLI can install Wix npm packages from the `lucy.json` file in the project directory.
+8.  **Wix NPM Package Installation**
+   - Lucy-CLI can install Wix npm packages from the `lucy.json` file.
 
-5. **Teting with Vitest**
+-9.  **Testing with Vitest**
    - Lucy-CLI can run tests with Vitest.
    - It runs tests located backend folder with the file name ending with `.spec.ts`.
    - it creates a code coverage report in the coverage folder in the lib folders and typescript folders.
    - Vitest is looking for mokes in typescript folder and lib folder.
      - You can add additional mock folders in vitest.config.ts file.
 
-6.  **Linting with ESLint**
+10. **Linting with ESLint**
     - Lucy-CLI can lint the code with ESLint.
     - It uses the ESLint configuration in the `.eslintrc.cjs` file in the project directory.  
 
-7.  **Add git version during production build**
+11. **Add git version during production build**
       - Lucy-CLI can add the git version to the production build.
       - It adds the git version to the `public/constant/env.ts` file in the public folder under the key gitTag.
-7. **Use velo-sync to synchronize local collection with wix**
+12. **Use velo-sync to synchronize local collection with wix**
       - Lucy-CLI can synchronize the local collection with the wix collection.
       - More information can be found in the [velo-sync](https://www.npmjs.com/package/velo-sync) documentation.
 
+13. **Synchronize `package.json` with `lucy.json`**
+    -   Lucy-CLI can synchronize dependencies from your project's `package.json` directly into the `lucy.json` configuration. The `dependencies` are mapped to `wixPackages` and `devDependencies` are mapped to `devPackages`.
+
+14. **Manage CLI Templates**
+    -   Lucy-CLI uses a templates folder (`~/.lucy-cli`) to store default configurations and file structures for the `init` command. The `templates` command allows you to easily open and customize these templates.
+
 ## Commands & Options
 
 Lucy-CLI comes with a range of commands and options to help manage your Wix Velo project. Here’s an overview:
@@ -105,11 +111,13 @@ Lucy-CLI comes with a range of commands and options to help manage your Wix Velo
 - **`dev`**: Starts the development environment, including setting up any required services for local development.
 - **`build-prod`**: Builds the project in production mode, optimizing files for deployment.
 - **`prepare`**: Re-runs initialization commands, useful for setting up a pre-configured environment.
-- **`velo-sync`**: Synchronizes the collections.
-- **`install`**: Installs all Wix npm packages listed in the `wixpkgs.json` file in the project directory.
+- **`velo-sync`**: Synchronizes Wix collections.
+- **`install`**: Installs all Wix and dev npm packages listed in the `lucy.json` file.
 - **`fix`**: Runs a fix command to resolve common issues in development or production settings.
-- **🦮 `docs`**: Generates documentation for the project.
-- **🦮 `cypress`**: Starts the Cypress test runner.
+- **`docs`**: Generates documentation for the project.
+- **`cypress`**: Starts the Cypress test runner.
+- **`templates`**: Opens the Lucy CLI templates folder.
+- **`sync-pkgs`**: Synchronizes dependencies from `package.json` to `lucy.json`.
 - **🦮 `e2e`**: Starts the Cypress test runner in CI mode.  
   **Usage:** `e2e <someKey> <someID>`  
   - **`someKey`**: The key for the test.  
@@ -136,7 +144,7 @@ lucy-cli dev
 # Synchronize database and settings
 lucy-cli sync
 
-# Install Wix npm packages from 'wixpkgs.json' with locked versions
+# Install Wix npm packages from 'lucy.json' with locked versions
 lucy-cli install -l
 
 # Force start the dev environment
@@ -149,29 +157,31 @@ lucy-cli help
 Usage: lucy-cli <command> [options]
 
 Commands:
-🦮 init               : Initializes the current folder as a Wix project by creating the necessary configuration files.
+🦮 init               : Initializes a WIX project to enable full TS support.
 🦮 dev                : Starts the development environment. This includes setting up any required services for local development.
 🦮 build-prod         : Builds the project in production mode, optimizing files for deployment.
-🦮 prepare            : Prepares the project by re-running initialization commands. Useful for setting up a pre-configured environment.
-🦮 velo-sync          : Synchronizes the collections.
-🦮 install            : Installs all Wix npm packages listed in the 'wixpkgs.json' file in the project directory.
+🦮 prepare            : Prepares the project by installing packages & initializing git modules, configured in lucy.json.
+🦮 velo-sync          : Synchronizes Wix collections (run `velo-sync -h` for help).
+🦮 install            : Installs all Wix and dev npm packages listed in the 'lucy.json' file.
 🦮 fix                : Runs a fix command to resolve common issues in development or production settings.
 🦮 docs               : Generates documentation for the project.
 🦮 cypress            : Starts the cypress test runner.
-🦮 e2e                : Starts the cypress test runner in CI mode. first argument is the key second is the build id <e2e <somekey <someID>
+🦮 templates          : Opens the Lucy CLI templates folder.
+🦮 sync-pkgs          : Syncs dependencies from package.json to lucy.json.
+🦮 e2e                : Starts the cypress test runner in CI mode. Usage: `e2e <key> <buildId>`
 
 Options:
 🦮 -h, help           : Displays this help message.
 🦮 -v, version        : Displays the current version of Lucy CLI as defined in the project’s package.json.
 🦮 -f, force          : Forces specific commands to execute even if they may lead to potential issues.
                       Used for functions like deleting obsolete pages or initializing missing components.
-🦮 -l                 : Locks package versions to those specified in the configuration file during installation.
+🦮 -l                 : Locks package versions to those specified in `lucy.json` during installation.
 
 Examples:
 🦮 lucy-cli init       : Initializes a new Wix project.
 🦮 lucy-cli dev        : Starts the development environment.
 🦮 lucy-cli sync       : Synchronizes database and settings.
-🦮 lucy-cli install    : Installs all Wix npm packages from 'wixpkgs.json'.
+🦮 lucy-cli install    : Installs all Wix and dev npm packages from 'lucy.json'.
 🦮 lucy-cli dev -f     : Starts the dev environment with forced settings.
 🦮 lucy-cli install -l : Installs Wix npm packages, respecting locked versions specified in the configuration.
 ```

package/dist/helpers.d.ts

@@ -17,3 +17,16 @@ export interface VeloSyncConfig {
 }
 export declare function saveConfig(config: VeloSyncConfig, file: string): Promise<void>;
 export declare function readConfig(file: string): Promise<VeloSyncConfig>;
+export declare function createTemplateFolder(moduleSettings: ModuleSettings): Promise<void>;
+export type PackageJson = {
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    [key: string]: any;
+};
+/**
+ * Updates a lucy.json file with dependencies from a package.json file.
+ * It replaces 'wixPackages' with 'dependencies' and 'devPackages' with 'devDependencies'.
+ * @param {string} packageJsonPath - Path to the package.json file.
+ * @param {string} lucyConfigPath - Path to the lucy.json file.
+ */
+export declare function updateLucyConfigFromPackageJson(packageJsonPath: string, lucyConfigPath: string): Promise<void>;

package/dist/helpers.js

@@ -1,12 +1,13 @@
 import chalk from 'chalk';
 import { simpleGit } from 'simple-git';
-import { spawnSync } from 'child_process';
+import { spawnSync, exec } from 'child_process';
 // https://www.sergevandenoever.nl/run-gulp4-tasks-programatically-from-node/
-import path from 'path';
+import path, { join } from 'path';
 import { fileURLToPath } from 'url';
-import { exec } from 'child_process';
 import os from 'os';
-import fs from 'fs';
+import fs, { mkdirSync } from 'fs';
+import fse from 'fs-extra';
+import { writeFile } from 'fs/promises';
 import { blue, green, orange, red, yellow, magenta } from './index.js';
 export async function installPackages(wixPackages, devPackages, cwd, locked) {
     if (locked)
@@ -168,3 +169,49 @@ export async function readConfig(file) {
     let content = await fs.promises.readFile(file, 'utf-8');
     return JSON.parse(content);
 }
+export async function createTemplateFolder(moduleSettings) {
+    const templatesPath = join(os.homedir(), '.lucy-cli');
+    try {
+        mkdirSync(templatesPath);
+        const defaultTemplatePath = join(templatesPath, 'default');
+        mkdirSync(defaultTemplatePath);
+        const sourceFilesPath = join(moduleSettings.packageRoot, 'files');
+        const defaultTemplateFilesPath = join(defaultTemplatePath, 'files');
+        await fse.copy(sourceFilesPath, defaultTemplateFilesPath);
+        const defaultTemplateSettingsPath = join(defaultTemplatePath, 'settings.json');
+        await writeFile(defaultTemplateSettingsPath, JSON.stringify(moduleSettings.settings, null, 2));
+        console.log(green('✅ Default template created successfully!'));
+    }
+    catch (e) {
+        console.log((`💩 ${red.underline.bold("=> Error creating default template =>")} ${orange(e)}`));
+        return;
+    }
+}
+/**
+ * Updates a lucy.json file with dependencies from a package.json file.
+ * It replaces 'wixPackages' with 'dependencies' and 'devPackages' with 'devDependencies'.
+ * @param {string} packageJsonPath - Path to the package.json file.
+ * @param {string} lucyConfigPath - Path to the lucy.json file.
+ */
+export async function updateLucyConfigFromPackageJson(packageJsonPath, lucyConfigPath) {
+    try {
+        console.log(`🐕 Reading package definitions from ${orange(packageJsonPath)}...`);
+        const pkgJsonContent = await fs.promises.readFile(packageJsonPath, 'utf-8');
+        const packageJson = JSON.parse(pkgJsonContent);
+        console.log(`🐕 Reading Lucy configuration from ${orange(lucyConfigPath)}...`);
+        const lucyConfigContent = await fs.promises.readFile(lucyConfigPath, 'utf-8');
+        const lucyConfig = JSON.parse(lucyConfigContent);
+        const { dependencies = {}, devDependencies = {} } = packageJson;
+        // Note: `wixPackages` are installed using `wix install`. If your `dependencies`
+        // contain packages that are not Wix packages, `lucy-cli install` might fail.
+        lucyConfig.wixPackages = dependencies;
+        lucyConfig.devPackages = devDependencies;
+        console.log(`🐕 Writing updated configuration to ${orange(lucyConfigPath)}...`);
+        await fs.promises.writeFile(lucyConfigPath, JSON.stringify(lucyConfig, null, 2));
+        console.log(green.underline('✅ Lucy configuration updated successfully!'));
+    }
+    catch (error) {
+        console.error(`💩 ${red.underline.bold('=> Error updating lucy.json from package.json:')} ${orange(error.message)}`);
+        throw error; // re-throw to allow caller to handle
+    }
+}

package/dist/index.js

@@ -11,9 +11,10 @@ import { join } from 'path';
 import fs from 'fs/promises';
 import { init } from './init.js';
 import { sync } from './sync.js';
-import { runGulp, installPackages, killAllProcesses, cleanupWatchers } from './helpers.js';
+import { runGulp, installPackages, killAllProcesses, cleanupWatchers, createTemplateFolder, updateLucyConfigFromPackageJson } from './helpers.js';
 import { prepare } from './prepare.js';
-import { spawnSync } from 'child_process';
+import { spawn, spawnSync } from 'child_process';
+import os from 'os';
 export const orange = chalk.hex('#FFA500');
 export const blue = chalk.blueBright;
 export const green = chalk.greenBright;
@@ -87,6 +88,33 @@ async function main() {
         console.log("🐾" + blue.bold(` => ${projectPackageJSON.version}`));
         return;
     }
+    if (moduleSettings.args.includes('templates')) {
+        const templatesPath = join(os.homedir(), '.lucy-cli');
+        if (!existsSync(templatesPath)) {
+            console.log((`💩 ${red.underline.bold("=> Lucy templates folder not found at =>")} ${orange(templatesPath)}`));
+            console.log(chalk.yellow('🐕 Creating templates folder with default template...'));
+            await createTemplateFolder(moduleSettings);
+        }
+        console.log(`🐕 ${blue.underline('Opening templates folder at:')} ${orange(templatesPath)}`);
+        let command;
+        switch (process.platform) {
+            case 'darwin':
+                command = 'open';
+                break;
+            case 'win32':
+                command = 'start';
+                break;
+            default:
+                command = 'xdg-open';
+                break;
+        }
+        const child = spawn(command, [templatesPath], { detached: true, stdio: 'ignore' });
+        child.on('error', (err) => {
+            console.error(`💩 ${red.underline.bold('Failed to open folder:')} ${orange(err.message)}`);
+        });
+        child.unref();
+        return;
+    }
     // Run velo sync
     if (moduleSettings.args.includes('velo-sync')) {
         await sync(moduleSettings, projectSettings);
@@ -105,6 +133,8 @@ async function main() {
         console.log("🦮 " + magenta.bold('fix') + "                : Runs a fix command to resolve common issues in development or production settings.");
         console.log("🦮 " + magenta.bold('docs') + "               : Generates documentation for the project.");
         console.log("🦮 " + magenta.bold('cypress') + "            : Starts the cypress test runner.");
+        console.log("🦮 " + magenta.bold('templates') + "          : Opens the Lucy CLI templates folder.");
+        console.log("🦮 " + magenta.bold('sync-pkgs') + "          : Syncs dependencies from package.json to lucy.json.");
         console.log("🦮 " + magenta.bold('e2e') + "                : Starts the cypress test runner in CI mode. first argument is the key second is the build id <e2e <somekey <someID>");
         console.log("\nOptions:");
         console.log("🦮 " + magenta.bold('-h, help') + "           : Displays this help message.");
@@ -235,6 +265,19 @@ async function main() {
         runGulp(moduleSettings, projectSettings, 'fix-wix');
         return;
     }
+    if (moduleSettings.args.includes('sync-pkgs')) {
+        console.log("🐕" + magenta.underline(' => Syncing package.json with lucy.json'));
+        if (!existsSync(moduleSettings.packageJsonPath)) {
+            console.log((`💩 ${red.underline.bold("=> package.json not found at =>")} ${orange(moduleSettings.packageJsonPath)}`));
+            return;
+        }
+        if (!existsSync(moduleSettings.lucyConfigPath)) {
+            console.log((`💩 ${red.underline.bold("=> lucy.json not found at =>")} ${orange(moduleSettings.lucyConfigPath)}`));
+            return;
+        }
+        await updateLucyConfigFromPackageJson(moduleSettings.packageJsonPath, moduleSettings.lucyConfigPath);
+        return;
+    }
     console.log("🐕" + blue.underline.bold(' => Running dev'));
     runGulp(moduleSettings, projectSettings, 'dev');
 }

package/dist/init.js

@@ -4,8 +4,11 @@ import fse from 'fs-extra';
 import { join } from 'path';
 import fs from 'fs/promises';
 import path from 'path';
+import os from 'os';
+import enquirer from 'enquirer';
 import { blue, orange, red } from './index.js';
-import { gitInit, installPackages } from './helpers.js';
+import { createTemplateFolder, gitInit, installPackages } from './helpers.js';
+const { Select } = enquirer;
 /**
  * Init Lucy project
  * @param {string} cwd Current working directory
@@ -17,7 +20,40 @@ export async function init(moduleSettings, projectSettings) {
         console.log((`💩 ${red.underline.bold("=> This project is already initialized =>")} ${orange(moduleSettings.targetFolder)}`));
         return;
     }
-    await copyFolder(join(moduleSettings.packageRoot, 'files'), moduleSettings.targetFolder);
+    const templatesPath = join(os.homedir(), '.lucy-cli');
+    if (!existsSync(templatesPath)) {
+        console.log(chalk.yellow(`Templates folder not found at ${orange(templatesPath)}. Creating it with a default template...`));
+        await createTemplateFolder(moduleSettings);
+    }
+    const templateChoices = (await fs.readdir(templatesPath, { withFileTypes: true }))
+        .filter(dirent => dirent.isDirectory())
+        .map(dirent => dirent.name);
+    if (templateChoices.length === 0) {
+        console.log((`💩 ${red.underline.bold("=> No templates found in =>")} ${orange(templatesPath)}`));
+        return;
+    }
+    const prompt = new Select({
+        name: 'template',
+        message: 'Select a project template',
+        choices: templateChoices
+    });
+    const selectedTemplate = await prompt.run();
+    const templateDir = join(templatesPath, selectedTemplate);
+    const templateFilesDir = join(templateDir, 'files');
+    const templateSettingsPath = join(templateDir, 'settings.json');
+    if (!existsSync(templateSettingsPath)) {
+        console.log((`💩 ${red.underline.bold("=> Template is missing settings.json at =>")} ${orange(templateSettingsPath)}`));
+        return;
+    }
+    try {
+        const templateSettingsRaw = await fs.readFile(templateSettingsPath, 'utf8');
+        moduleSettings.settings = JSON.parse(templateSettingsRaw);
+    }
+    catch (e) {
+        console.log((`💩 ${red.underline.bold("=> Error reading or parsing template settings =>")} ${orange(e)}`));
+        return;
+    }
+    await copyFolder(templateFilesDir, moduleSettings.targetFolder);
     await editJson(moduleSettings.packageJsonPath, ['type', 'scripts'], ['module', moduleSettings.settings.scripts]);
     await stringReplace(join(moduleSettings.targetFolder, 'currents.config.js'), ['__ProjectName__'], [path.basename(moduleSettings.targetFolder)]);
     await installPackages(moduleSettings.settings.wixPackages, moduleSettings.settings.devPackages, moduleSettings.targetFolder, moduleSettings.lockVersion);

package/dist/settings.json

@@ -12,48 +12,47 @@
     "initialized": false,
     "wixPackages": {},
     "devPackages": {
-        "@eslint/js": "^9.15.0",
+        "@eslint/js": "^9.30.1",
         "@styled/typescript-styled-plugin": "^1.0.1",
         "@total-typescript/ts-reset": "^0.6.1",
-        "@types/node": "^22.9.1",
+        "@types/node": "^24.0.10",
         "@types/nodemailer": "^6.4.17",
-        "typedoc-github-theme": "^0.2.0",
-        "@types/react": "^19.0.0",
-        "@vitest/ui": "^2.1.8",
-        "eslint-import-resolver-typescript": "^3.7.0",
-        "@vitest/coverage-v8": "^2.1.8",
-        "@typescript-eslint/eslint-plugin": "^8.15.0",
-        "@typescript-eslint/parser": "^8.15.0",
-        "@typescript-eslint/utils": "^8.15.0",
-        "@wix/cli": "^1.1.52",
+        "@types/react": "^19.1.8",
+        "@typescript-eslint/eslint-plugin": "^8.35.1",
+        "@typescript-eslint/parser": "^8.35.1",
+        "@typescript-eslint/utils": "^8.35.1",
+        "@vitest/coverage-v8": "^3.2.4",
+        "@vitest/ui": "^3.2.4",
+        "@wix/cli": "^1.1.101",
         "@wix/eslint-plugin-cli": "^1.0.2",
-        "cypress": "^13.16.0",
-        "cypress-cloud": "^1.11.0",
-        "esbuild": "^0.24.0",
-        "eslint": "^9.15.0",
+        "cypress": "^14.5.1",
+        "cypress-cloud": "^1.13.1",
+        "esbuild": "^0.25.5",
+        "eslint": "^9.30.1",
         "eslint-plugin-exception-handling": "^1.5.4",
-        "eslint-plugin-import": "^2.31.0",
-        "eslint-plugin-jsdoc": "^50.5.0",
+        "eslint-plugin-import": "^2.32.0",
+        "eslint-plugin-jsdoc": "^51.3.3",
         "eslint-plugin-named-import-spacing": "^1.0.3",
         "eslint-plugin-promise": "^7.2.1",
         "eslint-plugin-simple-import-sort": "^12.1.1",
-        "prettier": "^3.3.3",
-        "sass": "^1.81.0",
+        "prettier": "^3.6.2",
+        "sass": "^1.89.2",
         "ts-node": "^10.9.2",
-        "tsx": "^4.19.2",
-        "typedoc": "0.27.1",
-        "typescript": "5.6.3",
-        "typescript-eslint": "^8.15.0",
+        "tsx": "^4.20.3",
+        "typedoc": "^0.28.7",
+        "typedoc-github-theme": "^0.3.0",
+        "typescript": "^5.8.3",
+        "typescript-eslint": "^8.35.1",
         "typescript-eslint-language-service": "^5.0.5",
-        "vitest": "^2.1.8",
-        "vitest-tsconfig-paths": "^3.4.1",
-        "vite-tsconfig-paths": "^5.1.4"
+        "vite-tsconfig-paths": "^5.1.4",
+        "vitest": "^3.2.4",
+        "vitest-tsconfig-paths": "^3.4.1"
     },
     "scripts": {
         "postinstall": "wix sync-types",
         "wix:dev": "wix dev",
         "dev": "lucy-cli dev",
-        "lint": "eslint .",
+        "lint": "NODE_OPTIONS=\"--max-old-space-size=32768\" eslint .",
         "docs": "typedoc --tsconfig typescript/tsconfig.json --skipErrorChecking",
         "build": "lucy-cli build-prod",
         "fix-wix": "lucy-cli fix-wix",

package/files/.madgerc

@@ -0,0 +1,8 @@
+{
+  "fontSize": "10px",
+  "graphVizOptions": {
+    "G": {
+      "rankdir": "LR"
+    }
+  }
+}

package/files/.stylelintrc copy.js

@@ -0,0 +1,8 @@
+module.exports = {
+  overrides: [
+    {
+      files: ["**/*.{ts,tsx}"],
+      customSyntax: "@stylelint/postcss-css-in-js",
+    },
+  ],
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "lucy-cli",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "description": "Lucy Framework for WIX Studio Editor",
   "main": ".dist/index.js",
   "scripts": {
@@ -38,6 +38,7 @@
     "chalk": "^5.3.0",
     "cypress": "13.15.2",
     "cypress-cloud": "^1.9.3",
+    "enquirer": "^2.4.1",
     "glob": "^7.2.3",
     "gulp": "4.0.2",
     "gulp-clean": "^0.4.0",

package/src/helpers.ts

@@ -1,16 +1,16 @@
 import chalk from 'chalk';
 import { simpleGit } from 'simple-git';
-import { spawnSync } from 'child_process';
+import { spawnSync, exec } from 'child_process';
 // https://www.sergevandenoever.nl/run-gulp4-tasks-programatically-from-node/
-import path from 'path';
+import path, { join } from 'path';
 import { fileURLToPath } from 'url';
 import { LucySettings, ModuleSettings, ProjectSettings } from '.';
-import { exec } from 'child_process';
 import os from 'os';
-import fs from 'fs';
+import fs, { mkdirSync } from 'fs';
+import fse from 'fs-extra';
+import { writeFile } from 'fs/promises';
 
 import { blue, green, orange, red, yellow, magenta } from './index.js';
-import { fsync } from 'fs';
 
 export async function installPackages(wixPackages: Record<string, string>, devPackages: Record<string, string>,  cwd: string, locked: boolean ) {
 	if (locked) console.log("🐕" + blue.underline(` => Installing & version locked packages!`));
@@ -187,4 +187,67 @@ export async function saveConfig(config:VeloSyncConfig, file: string) {
 export async function readConfig(file: string): Promise<VeloSyncConfig> {
     let content = await fs.promises.readFile(file, 'utf-8');
     return JSON.parse(content);
+}
+
+export async function createTemplateFolder(moduleSettings: ModuleSettings) {
+        const templatesPath = join(os.homedir(), '.lucy-cli');
+    
+            try {
+            mkdirSync(templatesPath);
+
+            const defaultTemplatePath = join(templatesPath, 'default');
+            mkdirSync(defaultTemplatePath);
+
+            const sourceFilesPath = join(moduleSettings.packageRoot, 'files');
+            const defaultTemplateFilesPath = join(defaultTemplatePath, 'files');
+            await fse.copy(sourceFilesPath, defaultTemplateFilesPath);
+
+            const defaultTemplateSettingsPath = join(defaultTemplatePath, 'settings.json');
+            await writeFile(defaultTemplateSettingsPath, JSON.stringify(moduleSettings.settings, null, 2));
+
+            console.log(green('✅ Default template created successfully!'));
+        } catch (e) {
+            console.log((`💩 ${red.underline.bold("=> Error creating default template =>")} ${orange(e)}`));
+            return;
+        }
+}
+
+export type PackageJson = {
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    [key: string]: any;
+}
+
+/**
+ * Updates a lucy.json file with dependencies from a package.json file.
+ * It replaces 'wixPackages' with 'dependencies' and 'devPackages' with 'devDependencies'.
+ * @param {string} packageJsonPath - Path to the package.json file.
+ * @param {string} lucyConfigPath - Path to the lucy.json file.
+ */
+export async function updateLucyConfigFromPackageJson(packageJsonPath: string, lucyConfigPath: string): Promise<void> {
+    try {
+        console.log(`🐕 Reading package definitions from ${orange(packageJsonPath)}...`);
+        const pkgJsonContent = await fs.promises.readFile(packageJsonPath, 'utf-8');
+        const packageJson: PackageJson = JSON.parse(pkgJsonContent);
+
+        console.log(`🐕 Reading Lucy configuration from ${orange(lucyConfigPath)}...`);
+        const lucyConfigContent = await fs.promises.readFile(lucyConfigPath, 'utf-8');
+        const lucyConfig: LucySettings = JSON.parse(lucyConfigContent);
+
+        const { dependencies = {}, devDependencies = {} } = packageJson;
+
+        // Note: `wixPackages` are installed using `wix install`. If your `dependencies`
+        // contain packages that are not Wix packages, `lucy-cli install` might fail.
+        lucyConfig.wixPackages = dependencies;
+        lucyConfig.devPackages = devDependencies;
+
+        console.log(`🐕 Writing updated configuration to ${orange(lucyConfigPath)}...`);
+        await fs.promises.writeFile(lucyConfigPath, JSON.stringify(lucyConfig, null, 2));
+
+        console.log(green.underline('✅ Lucy configuration updated successfully!'));
+
+    } catch (error: any) {
+        console.error(`💩 ${red.underline.bold('=> Error updating lucy.json from package.json:')} ${orange(error.message)}`);
+        throw error; // re-throw to allow caller to handle
+    }
 }

package/src/index.ts

@@ -11,9 +11,10 @@ import fs from 'fs/promises';
 
 import { init } from './init.js';
 import { sync } from './sync.js';
-import { runGulp, installPackages, killAllProcesses, cleanupWatchers } from './helpers.js';
+import { runGulp, installPackages, killAllProcesses, cleanupWatchers, createTemplateFolder, updateLucyConfigFromPackageJson } from './helpers.js';
 import { prepare } from './prepare.js';
-import { spawnSync } from 'child_process';
+import { spawn, spawnSync } from 'child_process';
+import os from 'os';
 
 export type LucySettings = {
 	modules: {
@@ -147,6 +148,33 @@ async function main(): Promise<void> {
         
 		return;
 	}
+
+	if (moduleSettings.args.includes('templates')) {
+        const templatesPath = join(os.homedir(), '.lucy-cli');
+        if (!existsSync(templatesPath)) {
+            console.log((`💩 ${red.underline.bold("=> Lucy templates folder not found at =>")} ${orange(templatesPath)}`));
+			console.log(chalk.yellow('🐕 Creating templates folder with default template...'));
+			await createTemplateFolder(moduleSettings);
+        }
+
+        console.log(`🐕 ${blue.underline('Opening templates folder at:')} ${orange(templatesPath)}`);
+
+        let command: string;
+        switch (process.platform) {
+            case 'darwin': command = 'open'; break;
+            case 'win32': command = 'start'; break;
+            default: command = 'xdg-open'; break;
+        }
+        
+        const child = spawn(command, [templatesPath], { detached: true, stdio: 'ignore' });
+        child.on('error', (err) => {
+            console.error(`💩 ${red.underline.bold('Failed to open folder:')} ${orange(err.message)}`);
+        });
+        child.unref();
+        return;
+    }
+
+
 	// Run velo sync
 	if(moduleSettings.args.includes('velo-sync')){
 		await sync(moduleSettings, projectSettings);
@@ -167,6 +195,8 @@ async function main(): Promise<void> {
 		console.log("🦮 " + magenta.bold('fix') + "                : Runs a fix command to resolve common issues in development or production settings.");
 		console.log("🦮 " + magenta.bold('docs') + "               : Generates documentation for the project.");
 		console.log("🦮 " + magenta.bold('cypress') + "            : Starts the cypress test runner.");
+		console.log("🦮 " + magenta.bold('templates') + "          : Opens the Lucy CLI templates folder.");
+		console.log("🦮 " + magenta.bold('sync-pkgs') + "          : Syncs dependencies from package.json to lucy.json.");
 		console.log("🦮 " + magenta.bold('e2e') + "                : Starts the cypress test runner in CI mode. first argument is the key second is the build id <e2e <somekey <someID>");
 		console.log("\nOptions:");
 		console.log("🦮 " + magenta.bold('-h, help') + "           : Displays this help message.");
@@ -316,6 +346,21 @@ async function main(): Promise<void> {
 		return;	
 	}
 
+	if(moduleSettings.args.includes('sync-pkgs')){
+		console.log("🐕" + magenta.underline(' => Syncing package.json with lucy.json'));
+		if (!existsSync(moduleSettings.packageJsonPath)) {
+			console.log((`💩 ${red.underline.bold("=> package.json not found at =>")} ${orange(moduleSettings.packageJsonPath)}`));
+			return;
+		}
+		if (!existsSync(moduleSettings.lucyConfigPath)) {
+			console.log((`💩 ${red.underline.bold("=> lucy.json not found at =>")} ${orange(moduleSettings.lucyConfigPath)}`));
+			return;
+		}
+		await updateLucyConfigFromPackageJson(moduleSettings.packageJsonPath, moduleSettings.lucyConfigPath);
+		return;
+	}
+
+
 	console.log("🐕" + blue.underline.bold(' => Running dev'));
 	runGulp(moduleSettings, projectSettings, 'dev');
 }

package/src/init.ts

@@ -2,13 +2,14 @@ import chalk from 'chalk';
 import { existsSync, mkdirSync, promises as fsPromises } from 'fs';
 import fse from 'fs-extra';
 import { join } from 'path';
-import { simpleGit } from 'simple-git';
 import fs from 'fs/promises';
-import { spawnSync } from 'child_process';
 import path from 'path';
+import os from 'os';
+import enquirer from 'enquirer';
 import { ModuleSettings, ProjectSettings, blue, green, orange, red } from './index.js';
-import { gitInit, installPackages } from './helpers.js';
+import { createTemplateFolder, gitInit, installPackages } from './helpers.js';
 
+const { Select } = enquirer as any;
 /**
  * Init Lucy project
  * @param {string} cwd Current working directory
@@ -22,7 +23,46 @@ export async function init(moduleSettings: ModuleSettings, projectSettings: Proj
 		return;
 	}
 
-	await copyFolder(join(moduleSettings.packageRoot, 'files'), moduleSettings.targetFolder);
+	const templatesPath = join(os.homedir(), '.lucy-cli');
+    if (!existsSync(templatesPath)) {
+        console.log(chalk.yellow(`Templates folder not found at ${orange(templatesPath)}. Creating it with a default template...`));
+		await createTemplateFolder(moduleSettings);
+    }
+
+    const templateChoices = (await fs.readdir(templatesPath, { withFileTypes: true }))
+        .filter(dirent => dirent.isDirectory())
+        .map(dirent => dirent.name);
+
+    if (templateChoices.length === 0) {
+        console.log((`💩 ${red.underline.bold("=> No templates found in =>")} ${orange(templatesPath)}`));
+        return;
+    }
+
+    const prompt = new Select({
+        name: 'template',
+        message: 'Select a project template',
+        choices: templateChoices
+    });
+
+    const selectedTemplate = await prompt.run();
+    const templateDir = join(templatesPath, selectedTemplate);
+    const templateFilesDir = join(templateDir, 'files');
+    const templateSettingsPath = join(templateDir, 'settings.json');
+
+    if (!existsSync(templateSettingsPath)) {
+        console.log((`💩 ${red.underline.bold("=> Template is missing settings.json at =>")} ${orange(templateSettingsPath)}`));
+        return;
+    }
+
+    try {
+        const templateSettingsRaw = await fs.readFile(templateSettingsPath, 'utf8');
+        moduleSettings.settings = JSON.parse(templateSettingsRaw);
+    } catch (e) {
+        console.log((`💩 ${red.underline.bold("=> Error reading or parsing template settings =>")} ${orange(e)}`));
+        return;
+    }
+
+	await copyFolder(templateFilesDir, moduleSettings.targetFolder);
 
 	await editJson(moduleSettings.packageJsonPath, ['type', 'scripts'], ['module', moduleSettings.settings.scripts ]);
 	await stringReplace(join(moduleSettings.targetFolder, 'currents.config.js'), ['__ProjectName__'], [path.basename(moduleSettings.targetFolder)]);

package/src/settings.json

@@ -12,48 +12,47 @@
   "initialized": false,
   "wixPackages": {},
   "devPackages": {
-    "@eslint/js": "^9.15.0",
+    "@eslint/js": "^9.30.1",
     "@styled/typescript-styled-plugin": "^1.0.1",
     "@total-typescript/ts-reset": "^0.6.1",
-    "@types/node": "^22.9.1",
+    "@types/node": "^24.0.10",
     "@types/nodemailer": "^6.4.17",
-    "typedoc-github-theme": "^0.2.0",
-    "@types/react": "^19.0.0",
-    "@vitest/ui": "^2.1.8",
-    "eslint-import-resolver-typescript": "^3.7.0",
-    "@vitest/coverage-v8": "^2.1.8",
-    "@typescript-eslint/eslint-plugin": "^8.15.0",
-    "@typescript-eslint/parser": "^8.15.0",
-    "@typescript-eslint/utils": "^8.15.0",
-    "@wix/cli": "^1.1.52",
+    "@types/react": "^19.1.8",
+    "@typescript-eslint/eslint-plugin": "^8.35.1",
+    "@typescript-eslint/parser": "^8.35.1",
+    "@typescript-eslint/utils": "^8.35.1",
+    "@vitest/coverage-v8": "^3.2.4",
+    "@vitest/ui": "^3.2.4",
+    "@wix/cli": "^1.1.101",
     "@wix/eslint-plugin-cli": "^1.0.2",
-    "cypress": "^13.16.0",
-    "cypress-cloud": "^1.11.0",
-    "esbuild": "^0.24.0",
-    "eslint": "^9.15.0",
+    "cypress": "^14.5.1",
+    "cypress-cloud": "^1.13.1",
+    "esbuild": "^0.25.5",
+    "eslint": "^9.30.1",
     "eslint-plugin-exception-handling": "^1.5.4",
-    "eslint-plugin-import": "^2.31.0",
-    "eslint-plugin-jsdoc": "^50.5.0",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-jsdoc": "^51.3.3",
     "eslint-plugin-named-import-spacing": "^1.0.3",
     "eslint-plugin-promise": "^7.2.1",
     "eslint-plugin-simple-import-sort": "^12.1.1",
-    "prettier": "^3.3.3",
-    "sass": "^1.81.0",
+    "prettier": "^3.6.2",
+    "sass": "^1.89.2",
     "ts-node": "^10.9.2",
-    "tsx": "^4.19.2",
-    "typedoc": "0.27.1",
-    "typescript": "5.6.3",
-    "typescript-eslint": "^8.15.0",
+    "tsx": "^4.20.3",
+    "typedoc": "^0.28.7",
+    "typedoc-github-theme": "^0.3.0",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.35.1",
     "typescript-eslint-language-service": "^5.0.5",
-    "vitest": "^2.1.8",
-    "vitest-tsconfig-paths": "^3.4.1",
-    "vite-tsconfig-paths": "^5.1.4"
+    "vite-tsconfig-paths": "^5.1.4",
+    "vitest": "^3.2.4",
+    "vitest-tsconfig-paths": "^3.4.1"
   },
   "scripts": {
     "postinstall": "wix sync-types",
     "wix:dev": "wix dev",
     "dev": "lucy-cli dev",
-    "lint": "eslint .",
+    "lint": "NODE_OPTIONS=\"--max-old-space-size=32768\" eslint .",
     "docs": "typedoc --tsconfig typescript/tsconfig.json --skipErrorChecking",
     "build": "lucy-cli build-prod",
     "fix-wix": "lucy-cli fix-wix",