evophp 1.3.3 → 1.4.0

package/README.md

@@ -17,6 +17,7 @@ EvoPHP CLI is a command-line interface designed to simplify the development and
   * [Dependency Management](#dependency-management)
   * [Entry Management](#entry-management)
 * [Plugin & Theme Dependencies](#plugin--theme-dependencies)
+  * [Adding to Another Plugin](#adding-to-another-plugin)
 * [Authentication & PAT Storage](#authentication--pat-storage)
 * [Further Documentation](#further-documentation)
 
@@ -62,32 +63,53 @@ evophp init [project-name]
 ### Plugin/Theme Creation
 
 ```bash
-evophp new plugin <name>
-evophp new theme <name>
+evophp new plugin <name> [--local] [--for <parent-plugin>]
+evophp new theme <name> [--local] [--for <parent-plugin>]
 evophp n plugin <name>
 evophp n theme <name>
 ```
 
-* Creates a new plugin or theme from a template in **your own GitHub account**.
+* Creates a new plugin or theme from the boilerplates **bundled with the CLI** in its `templates/` folder — no network access is needed to scaffold:
 
-* Supports:
-  * Just `<name>` → Uses your GitHub account (token required)
-  * ⚠️ You can only create repositories under your GitHub account.
+  | Type | Template | Copied to |
+  |---|---|---|
+  | plugin (PHP) | `templates/plugin/php` | `Public/Modules/<name>` |
+  | plugin (JS) | `templates/plugin/js` | `EvoJsDev/Modules/<name>` |
+  | theme | `templates/theme` | `Public/Themes/<name>` |
+
+* Each new folder is initialised as its own git repo with an initial commit.
+
+* **GitHub (optional):** if a GitHub token is available (see [Authentication](#authentication--pat-storage)), EvoPHP then creates private repos in your account — `<name>` (and `<name>.js` for plugins) — and pushes to them. If GitHub can't be reached, you just get a warning; the plugin/theme is still created locally.
+
+* Options:
+  * `--local` → skip GitHub entirely (fully offline). Leaving the token prompt blank does the same.
+  * `--for <parent-plugin>` (alias `--parent`) → also record the new plugin/theme as a dependency of an existing plugin. See [Adding to Another Plugin](#adding-to-another-plugin).
 
 * Examples:
 
   ```bash
-  evophp new plugin MyPlugin              # Creates in your GitHub
-  evophp n theme MyTheme                  # Creates in your GitHub
+  evophp new plugin MyPlugin                  # Scaffold + create/push GitHub repos
+  evophp n theme MyTheme --local              # Scaffold only, no GitHub
+  evophp new plugin Reviews --for Shop        # Scaffold and add as a dependency of Shop
+  ```
+
+* To add a GitHub remote later for a `--local` plugin:
+
+  ```bash
+  cd Public/Modules/MyPlugin
+  git remote add origin https://github.com/<you>/MyPlugin.git
+  git push -u origin main
   ```
 
+> **Updating the templates:** the boilerplates are copies of `kinsokafor/EvoPlugin`, `kinsokafor/EvoPlugin.js` and `kinsokafor/EvoTheme`. When those change, refresh `templates/` in the CLI and publish a new version. Template `.gitignore` files are stored as `gitignore` (npm strips `.gitignore` on publish) and renamed back when copied.
+
 ---
 
 ### Plugin/Theme Installation
 
 ```bash
-evophp install plugin <name>
-evophp install theme <name>
+evophp install plugin <name> [--for <parent-plugin>]
+evophp install theme <name> [--for <parent-plugin>]
 evophp i plugin <name>
 evophp i theme <name>
 ```
@@ -98,11 +120,15 @@ evophp i theme <name>
   * Just `<name>` → Clones from your GitHub account (token required)
   * `<author>/<name>` → Clones from public GitHub repo (no token required)
 
+* Options:
+  * `--for <parent-plugin>` (alias `--parent`) → also record it as a dependency of an existing plugin. See [Adding to Another Plugin](#adding-to-another-plugin).
+
 * Examples:
 
   ```bash
   evophp install plugin MyPlugin
   evophp i theme johndoe/EvoTheme
+  evophp i plugin kinsokafor/Payments --for Shop
   ```
 
 * **Automatic dependency installation**: If the plugin or theme includes a `dependencies.json` file, EvoPHP will automatically install all listed JS/PHP packages and any dependent EvoPHP plugins or themes. See [Plugin & Theme Dependencies](#plugin--theme-dependencies).
@@ -244,6 +270,24 @@ When you run `evophp install`, EvoPHP will:
 3. Install all listed npm (`prod`/`dev`) and Composer (`prod`) packages.
 4. Recursively install any EvoPHP plugins or themes listed under `"plugin"` and `"theme"` — each of which may declare their own `dependencies.json`, resolved the same way.
 
+### Adding to Another Plugin
+
+`evophp install` and `evophp new` accept `--for <parent-plugin>` (alias `--parent`) to install or create a plugin/theme **and** record it in the parent's `EvoJsDev/Modules/<parent>/dependencies.json` in one step:
+
+```bash
+evophp install plugin kinsokafor/Payments --for Shop   # install from GitHub, add to Shop
+evophp new plugin Reviews --for Shop                   # create from template, add to Shop
+evophp new theme ShopSkin --local --for Shop           # works offline too
+```
+
+* The entry is written as `author/name` under `"plugin"` or `"theme"`, so `evophp install` / `evophp d <parent> --sync` pick it up for anyone else.
+* The parent plugin must already exist in the project, and a plugin can't depend on itself — both are checked before anything is installed or created.
+* Entries are de-duplicated; if the plugin is already installed, `install --for` just records it.
+* For `new`, the `author` is the owner of the GitHub repo that was created. When offline or using `--local`, you're asked for the GitHub username/org once and it is saved as `GITHUB_USER` in `.env.development`. Leaving it blank records just the name, with a warning to add the owner later.
+* The parent's `dependencies.json` is changed but not committed — commit it in the parent plugin's repo.
+
+This is equivalent to `evophp d <parent> --evoplugin` / `--evotheme`, but without the extra prompt, and it works for plugins you've just created.
+
 ### Automatic Uninstallation
 
 When you run `evophp uninstall`, EvoPHP will:
@@ -268,15 +312,19 @@ evophp uninstall plugin PluginA
 
 ## Authentication & PAT Storage
 
-When using a command with just `<name>` (e.g. `evophp new plugin MyPlugin`), EvoPHP CLI will:
+When a command needs GitHub (e.g. `evophp install plugin MyPlugin`, or `evophp new` creating your repos), EvoPHP CLI will:
 
 * Prompt you for a **GitHub Personal Access Token** (PAT) the first time
-* Automatically store it in `.env.development` for future use
+* Automatically store it in `.env.development` as `GITHUB_TOKEN` for future use
 * Use that token to fetch your GitHub username and manage private/public repos
 
+For `evophp new`, the token is optional — leave the prompt blank (or pass `--local`) to work offline.
+
+`.env.development` may also hold `GITHUB_USER`, the owner used for `author/name` dependency entries when `evophp new --for` runs offline.
+
 > ⚠️ You can only create repositories in your own GitHub account.
 
-> To change your token later, simply edit or delete `.env.development`.
+> To change your token or username later, simply edit or delete `.env.development`.
 
 ---
 

package/commands/dependencies.js

@@ -4,7 +4,7 @@ const { execSync } = require("child_process");
 const { readLineAsync } = require("../utils/helpers");
 const { getUserData } = require("../utils/github");
 const { cloneRepo } = require("../utils/git");
-const { installDependencies, extractDependencies } = require("../utils/dependencies");
+const { installDependencies, extractDependencies, addEvoRef } = require("../utils/dependencies");
 const log = require("../utils/logger");
 require("dotenv").config({ path: "./.env.development" });
 
@@ -56,17 +56,7 @@ async function installEvoDep(depType, dep, gitHubToken, dependencies) {
   }
 
   // Record as "author/name" in dependencies.json, deduplicated
-  const key = depType; // "plugin" or "theme"
-  const existing = (dependencies[key] || "")
-    .split(" ")
-    .map(d => d.trim())
-    .filter(Boolean);
-
-  const fullRef = `${author}/${depName}`;
-  if (!existing.some(d => d === fullRef || d.split("/").pop() === depName)) {
-    existing.push(fullRef);
-  }
-  dependencies[key] = existing.join(" ");
+  addEvoRef(dependencies, depType, `${author}/${depName}`);
 }
 
 module.exports = {

package/commands/help.js

@@ -16,14 +16,17 @@ module.exports = {
       → Example: evophp init my-coop-project
 
 🛠️  Plugin & Theme Creation:
-  evophp new plugin <name>
-  evophp new theme <name>
+  evophp new plugin <name> [--local]
+  evophp new theme <name> [--local]
+      → Copied from the bundled templates/plugin and templates/theme
+        boilerplates (no network). Private GitHub repos are then created and
+        pushed if a token is available; use --local or leave the token blank
+        to skip.
+      → Add --for <plugin> to also record it as a dependency of an
+        existing plugin (works with "evophp install" too).
   evophp n plugin <name>
   evophp n theme <name>
-      → Create a plugin or theme from template repo.
-      → Supports:
-         • just <name> → uses your GitHub account
-         • author/name → uses any GitHub account
+      → Short aliases for the above.
 
 ⬇️  Plugin & Theme Installation:
   evophp install plugin <name>

package/commands/install.js

@@ -4,7 +4,13 @@ const { execSync } = require('child_process');
 const { readLineAsync, mergeConfig, saveToEnv } = require('../utils/helpers');
 const { getUserData } = require('../utils/github');
 const { cloneRepo } = require('../utils/git');
-const { installDependencies, extractDependencies, mergeDependencies } = require('../utils/dependencies');
+const {
+  installDependencies,
+  extractDependencies,
+  mergeDependencies,
+  parentDependenciesFile,
+  addEvoDependency,
+} = require('../utils/dependencies');
 const log = require('../utils/logger');
 require("dotenv").config({ path: "./.env.development" });
 
@@ -107,9 +113,14 @@ module.exports = {
 
   builder: yargs => yargs
     .positional('type', { describe: 'plugin or theme', type: 'string' })
-    .positional('name', { describe: 'name or author/name', type: 'string' }),
-
-  handler: async ({ type, name }) => {
+    .positional('name', { describe: 'name or author/name', type: 'string' })
+    .option('for', {
+      alias: 'parent',
+      describe: 'Also record it as a dependency of this existing plugin',
+      type: 'string',
+    }),
+
+  handler: async ({ type, name, for: parent }) => {
     try {
       if (!type || !['plugin', 'theme'].includes(type.toLowerCase())) {
         type = await readLineAsync("What are you installing? (plugin/theme): ");
@@ -124,6 +135,9 @@ module.exports = {
         name = await readLineAsync(`Enter the ${type} name (e.g., myplugin or johndoe/myplugin): `);
       }
 
+      // Fail fast if the parent plugin isn't in this project
+      if (parent) parentDependenciesFile(parent);
+
       let author, pluginName;
       let gitHubToken = process.env.GITHUB_TOKEN;
 
@@ -146,9 +160,15 @@ module.exports = {
         ? [path.join('Public', 'Modules', pluginName), path.join('EvoJsDev', 'Modules', pluginName)]
         : [path.join('Public', 'Themes', pluginName)];
 
+      if (parent === pluginName) {
+        log.error(`A plugin cannot depend on itself.`);
+        process.exit(1);
+      }
+
       for (const p of paths) {
         if (fs.existsSync(p)) {
           log.warn(`${type} "${pluginName}" already exists at ${p}`);
+          if (parent) addEvoDependency(parent, type, `${author}/${pluginName}`);
           process.exit(0);
         }
       }
@@ -162,6 +182,8 @@ module.exports = {
 
       mergeConfig({});
 
+      if (parent) addEvoDependency(parent, type, `${author}/${pluginName}`);
+
       log.success(`The ${type} "${pluginName}" has been installed successfully.`);
 
     } catch (err) {

package/commands/new.js

@@ -1,8 +1,9 @@
 const path = require("path");
 const fs = require("fs");
 const { readLineAsync, mergeConfig } = require("../utils/helpers");
-const { getUserData, createGitHubRepo } = require("../utils/github");
-const { cloneRepo } = require("../utils/git");
+const { createEmptyRepo } = require("../utils/github");
+const { copyTemplate, initRepo, pushRepo } = require("../utils/template");
+const { parentDependenciesFile, addEvoDependency } = require("../utils/dependencies");
 const { editFile, renameFile } = require("../utils/edit");
 const { test } = require("../utils/validate");
 const log = require("../utils/logger");
@@ -22,20 +23,20 @@ module.exports = {
       .positional("name", {
         describe: "The plugin or theme name (without author)",
         type: "string",
+      })
+      .option("local", {
+        describe: "Skip creating GitHub repos (fully offline)",
+        type: "boolean",
+        default: false,
+      })
+      .option("for", {
+        alias: "parent",
+        describe: "Also record it as a dependency of this existing plugin",
+        type: "string",
       }),
 
-  handler: async ({ type, name }) => {
+  handler: async ({ type, name, local, for: parent }) => {
     try {
-      let gitHubToken = process.env.GITHUB_TOKEN;
-
-      if (!gitHubToken) {
-        gitHubToken = await readLineAsync(
-          "Enter GitHub Personal Access Token: "
-        );
-        const { saveToEnv } = require("../utils/helpers");
-        saveToEnv("GITHUB_TOKEN", gitHubToken);
-        log.success("GitHub token saved to .env.development");
-      }
       type = type.toLowerCase();
 
       if (!["plugin", "theme"].includes(type)) {
@@ -43,21 +44,49 @@ module.exports = {
         process.exit(1);
       }
 
-      // Get authenticated username from token
-      const userData = await getUserData(gitHubToken);
-      const author = userData.login;
       const pluginName = name;
 
-      log.info(`Authenticated as ${author}`);
-      log.info(`Creating ${type} "${pluginName}"...`);
+      if (parent) {
+        if (parent === pluginName) {
+          log.error("A plugin cannot depend on itself.");
+          process.exit(1);
+        }
+        // Fail fast if the parent plugin isn't in this project
+        parentDependenciesFile(parent);
+      }
+
+      // Plugins and themes are scaffolded from the bundled templates/ boilerplates.
+      // GitHub is only used afterwards to create and push to remote repos.
+      const gitHubToken = local ? null : await getToken();
 
+      log.info(`Creating ${type} "${pluginName}" from local template...`);
+
+      let owner;
       if (type === "plugin") {
-        const entry = await setupPlugin(gitHubToken, author, pluginName);
+        const entry = await setupPlugin(pluginName);
+        owner = await publishRepos(gitHubToken, [
+          { dest: path.join("Public", "Modules", pluginName), name: pluginName },
+          { dest: path.join("EvoJsDev", "Modules", pluginName), name: `${pluginName}.js` },
+        ]);
         log.success(`Plugin "${pluginName}" created with entry "${entry}"`);
       } else {
-        await setupTheme(gitHubToken, author, pluginName);
+        await setupTheme(pluginName);
+        owner = await publishRepos(gitHubToken, [
+          { dest: path.join("Public", "Themes", pluginName), name: pluginName },
+        ]);
         log.success(`Theme "${pluginName}" created`);
       }
+
+      if (parent) {
+        owner = owner || (await getOwner());
+        addEvoDependency(parent, type, owner ? `${owner}/${pluginName}` : pluginName);
+        if (!owner) {
+          log.warn(
+            `Recorded "${pluginName}" without an owner. Edit it to "owner/${pluginName}" in ` +
+            `EvoJsDev/Modules/${parent}/dependencies.json so others can install it.`
+          );
+        }
+      }
     } catch (err) {
       log.error(`Creation failed: ${err.message}`);
       process.exit(1);
@@ -65,8 +94,44 @@ module.exports = {
   },
 };
 
-async function setupPlugin(token, author, pluginName) {
-  const entry = await setupPluginRepo(token, author, pluginName);
+/**
+ * Get the GitHub token from env or prompt for it.
+ * A blank answer returns null, meaning skip GitHub.
+ */
+async function getToken() {
+  let gitHubToken = process.env.GITHUB_TOKEN;
+  if (gitHubToken) return gitHubToken;
+
+  gitHubToken = await readLineAsync(
+    "Enter GitHub Personal Access Token (leave blank to skip GitHub): "
+  );
+  if (!gitHubToken) return null;
+
+  const { saveToEnv } = require("../utils/helpers");
+  saveToEnv("GITHUB_TOKEN", gitHubToken);
+  log.success("GitHub token saved to .env.development");
+  return gitHubToken;
+}
+
+/**
+ * GitHub owner to use in "owner/name" dependency refs when no repo was
+ * created (offline). Cached as GITHUB_USER in .env.development.
+ */
+async function getOwner() {
+  if (process.env.GITHUB_USER) return process.env.GITHUB_USER;
+
+  const owner = await readLineAsync(
+    "GitHub username/org that will own this repo (leave blank to skip): "
+  );
+  if (!owner) return null;
+
+  const { saveToEnv } = require("../utils/helpers");
+  saveToEnv("GITHUB_USER", owner);
+  return owner;
+}
+
+async function setupPlugin(pluginName) {
+  const entry = await setupPluginRepo(pluginName);
   const pluginPrefix = entry.replace("Main", "");
 
   await editFile(`./Public/Modules/${pluginName}/Routes.php`, {
@@ -92,20 +157,9 @@ async function setupPlugin(token, author, pluginName) {
   return entry;
 }
 
-async function setupPluginRepo(token, author, pluginName) {
-  await createGitHubRepo(token, "kinsokafor/EvoPlugin", pluginName);
-  await cloneRepo(
-    author,
-    pluginName,
-    path.join("Public", "Modules", pluginName)
-  );
-
-  await createGitHubRepo(token, "kinsokafor/EvoPlugin.js", `${pluginName}.js`);
-  await cloneRepo(
-    author,
-    `${pluginName}.js`,
-    path.join("EvoJsDev", "Modules", pluginName)
-  );
+async function setupPluginRepo(pluginName) {
+  copyTemplate("plugin/php", path.join("Public", "Modules", pluginName));
+  copyTemplate("plugin/js", path.join("EvoJsDev", "Modules", pluginName));
 
   const pluginPrefix = await getValidatedInput("Enter Plugin Prefix?", 3, true);
   const entryURI = await getValidatedInput("Entry URI?", 20);
@@ -129,13 +183,34 @@ async function setupPluginRepo(token, author, pluginName) {
   return entry;
 }
 
-async function setupTheme(token, author, themeName) {
-  await createGitHubRepo(token, "kinsokafor/EvoTheme", themeName);
-  await cloneRepo(
-    author,
-    themeName,
-    path.join("Public", "Themes", themeName)
-  );
+/**
+ * Commit both plugin folders as fresh repos, then (if a token was given and
+ * GitHub is reachable) create private remotes and push. Offline is fine.
+ */
+async function publishRepos(token, repos) {
+  let owner = null;
+
+  for (const { dest, name } of repos) {
+    const remoteUrl = token
+      ? await createEmptyRepo(token, name, `${name}, created from an evophp template.`)
+      : null;
+    initRepo(dest, remoteUrl);
+    if (remoteUrl) {
+      pushRepo(dest);
+      // https://github.com/<owner>/<name>.git
+      owner = owner || remoteUrl.split("/").slice(-2)[0];
+    }
+  }
+
+  if (!token) {
+    log.info("Skipped GitHub. Add remotes later with: git remote add origin <url> && git push -u origin main");
+  }
+
+  return owner;
+}
+
+async function setupTheme(themeName) {
+  copyTemplate("theme", path.join("Public", "Themes", themeName));
 
   await editFile(`./Public/Themes/${themeName}/Data/index.data.php`, {
     themeName,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evophp",
-  "version": "1.3.3",
+  "version": "1.4.0",
   "description": "Command-line installer for the Evolution PHP framework",
   "bin": {
     "evophp": "bin/evophp.js"

package/templates/plugin/js/Entry/index.js

@@ -0,0 +1,11 @@
+import {createApp} from 'vue'
+import app from '@/components/AppMount.vue'
+import router from './router'
+import { createPinia } from 'pinia'
+import restricted from '@/plugins/restricted'
+
+createApp(app)
+        .use(createPinia())
+        .use(restricted)
+        .use(router)
+        .mount("#app")

package/templates/plugin/js/Entry/router/index.js

@@ -0,0 +1,27 @@
+import { createRouter, createWebHashHistory } from 'vue-router'
+import NotFound from '@/components/NotFound.vue'
+import Dashboard from '../views/Dashboard.vue'
+
+const router = createRouter({
+    history: createWebHashHistory(),
+    routes: [{
+            path: '/:pathMatch(.*)*',
+            name: 'NotFound',
+            component: NotFound,
+            meta: { title: "404 Not Found" }
+        },
+        {
+            path: '/',
+            name: 'Dashboard',
+            component: Dashboard,
+            meta: { title: "Dashboard" }
+        }
+    ]
+});
+
+router.beforeEach((to, from, next) => {
+    document.title = `${to.meta.title}`;
+    next();
+});
+
+export default router;

package/templates/plugin/js/Entry/views/Dashboard.vue

@@ -0,0 +1,8 @@
+<template>
+    <div>
+    </div>
+</template>
+<script setup>
+</script>
+<style lang="scss" scoped>
+</style>

package/templates/plugin/js/config.json

@@ -0,0 +1,14 @@
+{
+    "modules":
+    {
+        "<pluginName>":
+        {
+            "entry": [
+                "<entry>/index"
+            ],
+            "active": true,
+            "installed": false,
+            "order": 1
+        }
+    }
+}

package/templates/plugin/js/dependencies.json

@@ -0,0 +1,4 @@
+{
+    "prod": "",
+    "dev": ""
+}

package/templates/plugin/js/store/sample.js

@@ -0,0 +1,76 @@
+import { defineStore } from 'pinia';
+import { dbTable, storeGetter, updateStoreDataSingle, updateStoreData, storeLoaderController } from '@/helpers';
+import _ from 'lodash';
+
+export const useSampleStore = defineStore('useSampleStore', {
+    state: () => {
+        return {
+            data: [],
+            processing: false,
+            fetching: false,
+            limit: 100,
+            offset: 0,
+            dbtable: new dbTable,
+            lastTimeOut: null
+        }
+    },
+    actions: {
+        async loadFromServer(params = {}) {
+            for (var k in params) {
+                //return when all data are not ready
+                if (params[k] == undefined) return;
+            }
+            this.fetching = true;
+            this.processing = true;
+            await this.dbtable.get('tableName', {
+                limit: this.limit,
+                offset: this.offset,
+                order: 'asc',
+                order_by: 'id',
+                ...params
+            }).then(r => {
+                if ("id" in params) {
+                    this.data = updateStoreDataSingle(this.data, r.data)
+                } else {
+                    this.data = updateStoreData(this.data, r.data)
+                    if (r.data.length >= this.limit && params?.limit === undefined) {
+                        this.offset = this.limit + this.offset
+                        storeLoaderController(this, () => {
+                            this.loadFromServer(params)
+                        })
+                    } else {
+                        this.offset = 0
+                        if(this.lastTimeOut != null) {
+                            clearTimeout(this.lastTimeOut)
+                        }
+                        this.lastTimeOut = setTimeout(() => {
+                            this.fetching = false
+                        }, 3600000)
+                    }
+                }
+                
+            })
+        },
+
+        abort() {
+            this.dbtable.abort()
+            this.fetching = false;
+        }
+    },
+    getters: {
+        all: (state) => {
+            if (!state.fetching) {
+                state.loadFromServer()
+            }
+            return state.data;
+        },
+        get: (state) => {
+            const data = state.data
+            return (params = {}, ...exclude) => {
+                return storeGetter(state, data, (tempParams) => {
+                    state.loadFromServer(tempParams)
+                }, params, exclude)
+            }
+        }
+    }
+})

package/templates/plugin/php/Controller.php

@@ -0,0 +1,34 @@
+<?php 
+
+namespace Public\Modules\<pluginName>;
+
+use EvoPhp\Api\Controllers;
+use EvoPhp\Api\Config;
+
+class <pluginPrefix>Controller extends Controllers
+{
+
+    public function __construct()
+    {
+        parent::__construct();
+        $this->viewPath = __DIR__.'/Views';
+        $this->config = new Config;
+    }
+
+    public function getData($data) {
+        if(method_exists($this, $this->dataMethod)) {
+            $callback = $this->dataMethod;
+            return $this->$callback($data);
+        }
+        return false;
+    }
+
+    public function addResources() {
+        if(method_exists($this, $this->resourceMethod)) {
+            $callback = $this->resourceMethod;
+            return $this->$callback();
+        }
+        return false;
+    }
+    
+}

package/templates/plugin/php/Install.php

@@ -0,0 +1,3 @@
+<?php 
+    
+?>

package/templates/plugin/php/Routes.php

@@ -0,0 +1,13 @@
+<?php  
+
+use Public\Modules\<pluginName>\<pluginPrefix>Controller;
+use EvoPhp\Api\Requests\Requests;
+
+//API End points
+
+//Pages
+
+$router->get('/<entryURI>', function($params){
+    $controller = new <pluginPrefix>Controller;
+    $controller->{'<entry>/index'}($params)->auth(2,3,4)->setData(["pageTitle" => "Admin"]);
+}); 

package/templates/plugin/php/Views/Entry/index.blade.php

@@ -0,0 +1,2 @@
+<div id="app">{!! $appLoader !!}</div>
+<div id="app-data" content="{{$encoded}}"></div>

package/templates/plugin/php/gitignore

@@ -0,0 +1 @@
+/Views/cache

package/templates/theme/Data/index.data.php

@@ -0,0 +1,27 @@
+<?php
+
+use EvoPhp\Resources\Options;
+use Assoto\CSS;
+use Assoto\JS;
+use Assoto\Stack;
+
+// CSS::stylesheet(
+//     "https://cdn.jsdelivr.net/npm/bootstrap@5.2.0/dist/css/bootstrap.min.css",
+//     "bootstrap5"
+// );
+
+// JS::file(
+//     "./Public/Themes/<themeName>/Assets/js/jquery.min.js",
+//     "jQuery",
+//     array(),
+//     Stack::STACK_HEAD
+// );
+
+// JS::file(
+//     "./Public/Themes/<themeName>/Assets/js/main-min.js",
+//     "ThemeMain"
+// );
+
+return [
+    "inputFieldClass" => "form-control form-control-user"
+];

package/templates/theme/Data/login.data.php

@@ -0,0 +1,32 @@
+<?php
+
+use EvoPhp\Resources\Options;
+use Assoto\CSS;
+use Assoto\JS;
+use Assoto\Stack;
+
+// CSS::stylesheet(
+//     "https://cdn.jsdelivr.net/npm/bootstrap@5.2.0/dist/css/bootstrap.min.css",
+//     "bootstrap5"
+// );
+
+// JS::file(
+//     "./Public/Themes/<themeName>/Assets/js/jquery.min.js",
+//     "jQuery",
+//     array(),
+//     Stack::STACK_HEAD
+// );
+
+// JS::file(
+//     "./Public/Themes/<themeName>/Assets/js/main-min.js",
+//     "ThemeMain"
+// );
+
+return [
+    "loginFormClass" => "user",
+    "loginInputClass" => "form-control form-control-user",
+    "loginButtonClass" => "btn btn-primary btn-user btn-block"
+];
+
+
+?>

package/templates/theme/Views/index.blade.php

@@ -0,0 +1,7 @@
+@extends('layouts.parts')
+
+@section('assets', '/Public/Themes/<themeName>/Assets/')
+
+@section('content')
+    {!! $content !!}
+@endsection

package/templates/theme/Views/layouts/loginparts.blade.php

@@ -0,0 +1,25 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+
+    <meta charset="utf-8">
+    <meta http-equiv="X-UA-Compatible" content="IE=edge">
+    <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
+    <meta name="description" content="">
+    <meta name="author" content="">
+    <title></title>
+    <link href="/color-scheme.css" rel="stylesheet" />
+    <!-- Custom styles for this template-->
+    <link href="@yield('assets')style.css" rel="stylesheet">
+    {!! Assoto\Stack::display('head') !!}
+</head>
+
+<body>
+    @section('content')
+        @yield('content') 
+    @show
+    {!! Assoto\Stack::display('footer') !!}
+</body>
+
+</html>

package/templates/theme/Views/layouts/parts.blade.php

@@ -0,0 +1,48 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+
+    <meta charset="utf-8">
+    <meta http-equiv="X-UA-Compatible" content="IE=edge">
+    <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
+    <meta name="description" content="">
+    <meta name="author" content="">
+    <title></title>
+    <link href="/color-scheme.css" rel="stylesheet" />
+    <!-- Custom styles for this template-->
+    <link href="@yield('assets')style.css" rel="stylesheet">
+    {!! Assoto\Stack::display('head') !!}
+</head>
+
+<body>
+    <script>0</script>
+        <!-- Nav Items -->
+        @foreach($mainMenu as $menu)
+        @if(\EvoPhp\Api\Operations::checkAccess($menu['access']))
+            <!-- {{$menu['iconClass']}} -->
+            <!-- {{$loop->index}} -->
+            <!-- @isset($menu['submenu']) collapsed @endisset -->
+            <!-- {{$menu['link']}} -->
+            <!-- {{$menu['label']}} -->
+            @isset($menu['submenu'])
+                @foreach($menu['submenu'] as $submenu)
+                @if(isset($submenu['access']) && \EvoPhp\Api\Operations::checkAccess($submenu['access']))
+                    <!-- {{$submenu['link']}} -->
+                    <!-- {{$submenu['label']}} -->
+                @endif
+                @endforeach
+            @endisset
+        @endif
+        @endforeach
+
+        @section('content')
+            @yield('content') 
+        @show
+
+        <!-- <span>Copyright &copy; {{$site_name}} {{date('Y')}}</span> -->
+
+    {!! Assoto\Stack::display('footer') !!}
+</body>
+
+</html>

package/templates/theme/Views/login.blade.php

@@ -0,0 +1,21 @@
+@extends('layouts.loginparts')
+
+@section('assets', '/Public/Themes/<themeName>/Assets/')
+
+@section('content')
+    {!! $content !!}
+    <hr>
+    <a href="index.html" class="btn btn-google btn-user btn-block">
+        <i class="fab fa-google fa-fw"></i> Login with Google
+    </a>
+    <a href="index.html" class="btn btn-facebook btn-user btn-block">
+        <i class="fab fa-facebook-f fa-fw"></i> Login with Facebook
+    </a>
+    <hr>
+    <div class="text-center">
+        <a class="small" href="forgot-password.html">Forgot Password?</a>
+    </div>
+    <div class="text-center">
+        <a class="small" href="register.html">Create an Account!</a>
+    </div>
+@endsection

package/templates/theme/gitignore

@@ -0,0 +1 @@
+/Views/cache

package/utils/dependencies.js

@@ -58,4 +58,67 @@ async function mergeDependencies(newDep, oldDep) {
     return res;
 }
 
-module.exports = { installDependencies, extractDependencies, mergeDependencies };
+/**
+ * Add an evophp plugin/theme reference to an in-memory dependencies object,
+ * deduplicated by full ref or bare name. Returns true if it was added.
+ *
+ * @param {object} dependencies
+ * @param {'plugin'|'theme'} key
+ * @param {string} ref - "author/name" (or bare "name" when the author is unknown)
+ */
+function addEvoRef(dependencies, key, ref) {
+  const name = ref.split("/").pop();
+  const existing = (dependencies[key] || "")
+    .split(" ")
+    .map(d => d.trim())
+    .filter(Boolean);
+
+  if (existing.some(d => d === ref || d.split("/").pop() === name)) return false;
+
+  existing.push(ref);
+  dependencies[key] = existing.join(" ");
+  return true;
+}
+
+/**
+ * Path to a parent plugin's evophp dependencies.json. Exits if the parent
+ * plugin is not present in this project.
+ * @param {string} parent
+ */
+function parentDependenciesFile(parent) {
+  const dir = path.join("EvoJsDev", "Modules", parent);
+  if (!fs.existsSync(dir)) {
+    log.error(`Parent plugin "${parent}" not found at ${dir}`);
+    process.exit(1);
+  }
+  return path.join(dir, "dependencies.json");
+}
+
+/**
+ * Record an evophp plugin/theme as a dependency of a parent plugin.
+ * @param {string} parent - parent plugin name
+ * @param {'plugin'|'theme'} type
+ * @param {string} ref - "author/name"
+ */
+function addEvoDependency(parent, type, ref) {
+  const file = parentDependenciesFile(parent);
+  const dependencies = fs.existsSync(file)
+    ? JSON.parse(fs.readFileSync(file, "utf-8"))
+    : {};
+
+  if (addEvoRef(dependencies, type, ref)) {
+    fs.writeFileSync(file, JSON.stringify(dependencies, null, 2));
+    log.success(`Added ${type} "${ref}" as a dependency of "${parent}".`);
+  } else {
+    log.info(`${type} "${ref}" is already a dependency of "${parent}".`);
+  }
+}
+
+module.exports = {
+  installDependencies,
+  extractDependencies,
+  mergeDependencies,
+  addEvoRef,
+  parentDependenciesFile,
+  addEvoDependency,
+};

package/utils/github.js

@@ -46,4 +46,30 @@ async function createGitHubRepo(token, templateRepo, pluginName) {
   }
 }
 
-module.exports = { getUserData, createGitHubRepo };
+/**
+ * Create an empty private repo for the authenticated user.
+ * Returns the clone URL, or null if it could not be created (e.g. offline).
+ */
+async function createEmptyRepo(token, repoName, description = "") {
+  try {
+    const res = await axios.post(
+      "https://api.github.com/user/repos",
+      { name: repoName, private: true, description },
+      {
+        headers: {
+          Authorization: `token ${token}`,
+          Accept: "application/vnd.github.v3+json",
+        },
+        timeout: 15000,
+      }
+    );
+    log.success(`Created GitHub repo ${res.data.full_name}`);
+    return res.data.clone_url;
+  } catch (e) {
+    const msg = e.response?.data?.message || e.message;
+    log.warn(`Could not create GitHub repo ${repoName}: ${msg}`);
+    return null;
+  }
+}
+
+module.exports = { getUserData, createGitHubRepo, createEmptyRepo };

package/utils/template.js

@@ -0,0 +1,75 @@
+const { execSync } = require("child_process");
+const fs = require("fs");
+const path = require("path");
+const rimraf = require("rimraf");
+const log = require("./logger");
+
+const TEMPLATES_DIR = path.join(__dirname, "..", "templates");
+
+/**
+ * Copy a bundled boilerplate from templates/ into a destination folder
+ * and initialise it as a fresh git repo. No network access needed.
+ *
+ * npm strips ".gitignore" files on publish, so templates store them as
+ * "gitignore" and they are renamed back here.
+ *
+ * @param {string} template - Path relative to templates/ (e.g. "plugin/php")
+ * @param {string} dest - Local destination path
+ */
+function copyTemplate(template, dest) {
+  const src = path.join(TEMPLATES_DIR, template);
+
+  if (!fs.existsSync(src)) {
+    log.error(`Template not found: ${src}`);
+    process.exit(1);
+  }
+
+  if (fs.existsSync(dest)) {
+    log.warn(`Deleting existing folder: ${dest}`);
+    rimraf.sync(dest);
+  }
+
+  log.info(`Copying template ${template} → ${dest}`);
+  fs.cpSync(src, dest, { recursive: true });
+
+  const ignore = path.join(dest, "gitignore");
+  if (fs.existsSync(ignore)) {
+    fs.renameSync(ignore, path.join(dest, ".gitignore"));
+  }
+}
+
+/**
+ * Initialise a git repo with an initial commit, optionally adding a remote.
+ * @param {string} dest
+ * @param {string|null} remoteUrl
+ */
+function initRepo(dest, remoteUrl = null) {
+  try {
+    execSync("git init -b main", { cwd: dest, stdio: "ignore" });
+    execSync("git add -A", { cwd: dest, stdio: "ignore" });
+    execSync('git commit -m "Initial commit from evophp template"', {
+      cwd: dest,
+      stdio: "ignore",
+    });
+    if (remoteUrl) {
+      execSync(`git remote add origin ${remoteUrl}`, { cwd: dest, stdio: "ignore" });
+    }
+    log.success(`Initialised git repo in ${dest}`);
+  } catch (e) {
+    log.warn(`Could not initialise git repo in ${dest}: ${e.message}`);
+  }
+}
+
+/**
+ * Push the local repo to its origin remote. Failure is non-fatal.
+ * @param {string} dest
+ */
+function pushRepo(dest) {
+  try {
+    execSync("git push -u origin main", { cwd: dest, stdio: "inherit" });
+  } catch (e) {
+    log.warn(`Push failed for ${dest}; push manually later with "git push -u origin main".`);
+  }
+}
+
+module.exports = { copyTemplate, initRepo, pushRepo };