@bariskuran/create-base 0.0.0-stage → 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Baris Kuran
+
+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

@@ -1,3 +1,15 @@
-# Temporary Holding Version
+# @bariskuran/create-base
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Create a project from the Base starter template:
+
+```sh
+npm create @bariskuran/base
+```
+
+The setup asks for a workspace folder name, project name, title, description, URL, developer name, and contact details. It creates the project, installs dependencies with Yarn, and then you can start it with `yarn start`.
+
+You can also run the initializer directly:
+
+```sh
+npx @bariskuran/create-base
+```

package/bin/create-base.cjs

@@ -0,0 +1,275 @@
+#!/usr/bin/env node
+const fs = require("node:fs");
+const path = require("node:path");
+const { spawnSync } = require("node:child_process");
+const readline = require("node:readline/promises");
+const { stdin, stdout } = require("node:process");
+
+const TEMPLATE_DIR = path.join(__dirname, "..", "template");
+const RESERVED_NAMES = /^(con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\..*)?$/i;
+
+function isValidWorkspaceName(value) {
+    return (
+        value.length > 0 &&
+        value.length <= 100 &&
+        /^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(value) &&
+        !RESERVED_NAMES.test(value)
+    );
+}
+
+function isValidProjectName(value) {
+    return (
+        value.length <= 214 &&
+        /^(?:@[a-z0-9][a-z0-9._~-]*\/)?[a-z0-9][a-z0-9._~-]*$/.test(value) &&
+        !value.includes("..") &&
+        !value.startsWith(".") &&
+        !value.startsWith("_")
+    );
+}
+
+async function askRequired(rl, prompt, validate, errorMessage) {
+    while (true) {
+        const value = (await rl.question(prompt)).trim();
+        if (value && validate(value)) return value;
+        console.log(errorMessage);
+    }
+}
+
+async function askYesNo(rl, prompt) {
+    while (true) {
+        const value = (await rl.question(prompt)).trim().toLowerCase();
+        if (["y", "yes"].includes(value)) return true;
+        if (["n", "no", ""].includes(value)) return false;
+        console.log("Please answer yes or no.");
+    }
+}
+
+async function askConflictPolicy(rl) {
+    while (true) {
+        const answer = (await rl.question(
+            "For later conflicts, should I prompt you each time or reuse this choice? [prompt/reuse]: ",
+        ))
+            .trim()
+            .toLowerCase();
+
+        if (["prompt", "p"].includes(answer)) return "prompt";
+        if (["reuse", "r"].includes(answer)) return "reuse";
+        console.log("Please enter 'prompt' or 'reuse'.");
+    }
+}
+
+async function collectAnswers(rl) {
+    console.log("Create a new Base project. Press Ctrl+C to cancel.\n");
+
+    const workspaceName = await askRequired(
+        rl,
+        "Workspace folder name (lowercase letters, numbers, and hyphens): ",
+        isValidWorkspaceName,
+        "Use 1–100 lowercase ASCII letters or numbers, separated by single hyphens. Avoid reserved system names.",
+    );
+    const projectName = await askRequired(
+        rl,
+        "Project/package name: ",
+        isValidProjectName,
+        "Enter a valid npm package name using lowercase letters, numbers, dots, underscores, or hyphens (an optional scope is allowed).",
+    );
+    const projectTitle = await askRequired(rl, "Project title: ", () => true, "Enter a project title.");
+    const projectDescription = await askRequired(
+        rl,
+        "Project description: ",
+        () => true,
+        "Enter a project description.",
+    );
+    const projectUrl = await askRequired(
+        rl,
+        "Project URL (https://...): ",
+        (value) => {
+            try {
+                return ["http:", "https:"].includes(new URL(value).protocol);
+            } catch {
+                return false;
+            }
+        },
+        "Enter a valid http or https URL.",
+    );
+    const developerName = await askRequired(rl, "Developer name: ", () => true, "Enter a developer name.");
+    const developerContact = await askRequired(
+        rl,
+        "Developer contact (email, website, or other contact): ",
+        () => true,
+        "Enter developer contact information.",
+    );
+
+    return { workspaceName, projectName, projectTitle, projectDescription, projectUrl, developerName, developerContact };
+}
+
+function replaceEnvValue(envText, key, value) {
+    const encoded = JSON.stringify(value);
+    const matcher = new RegExp(`^${key}=.*$`, "m");
+    if (!matcher.test(envText)) throw new Error(`The template is missing ${key} in its .env file.`);
+    return envText.replace(matcher, `${key}=${encoded}`);
+}
+
+async function writeCustomizedFiles(targetDir, answers) {
+    if (!answers.skipped.has("package.json")) {
+        const packagePath = path.join(targetDir, "package.json");
+        const packageJson = JSON.parse(await fs.promises.readFile(packagePath, "utf8"));
+        packageJson.name = answers.projectName;
+        packageJson.description = answers.projectDescription;
+        packageJson.author = `${answers.developerName} <${answers.developerContact}>`;
+        await fs.promises.writeFile(packagePath, `${JSON.stringify(packageJson, null, 4)}\n`);
+    }
+
+    if (!answers.skipped.has(".env")) {
+        const envPath = path.join(targetDir, ".env");
+        let envText = await fs.promises.readFile(envPath, "utf8");
+        envText = replaceEnvValue(envText, "VITE_SITE_TITLE", answers.projectTitle);
+        envText = replaceEnvValue(envText, "VITE_SITE_DESCRIPTION", answers.projectDescription);
+        envText = replaceEnvValue(envText, "VITE_SITE_URL", answers.projectUrl);
+        envText = replaceEnvValue(envText, "VITE_DEVELOPER_NAME", answers.developerName);
+        await fs.promises.writeFile(envPath, envText);
+    }
+
+    if (!answers.skipped.has("LICENSE")) {
+        const licensePath = path.join(targetDir, "LICENSE");
+        const licenseText = await fs.promises.readFile(licensePath, "utf8");
+        const currentYear = new Date().getFullYear();
+        const personalizedLicense = licenseText
+            .replaceAll("[YEAR]", String(currentYear))
+            .replaceAll("[DEVELOPER_NAME]", answers.developerName)
+            .replaceAll("[DEVELOPER_CONTACT]", answers.developerContact);
+        await fs.promises.writeFile(licensePath, personalizedLicense);
+    }
+}
+
+function promptOverwrite(relativePath) {
+    return `\n\"${relativePath}\" already exists. Do you want to overwrite it? [y/N]: `;
+}
+
+async function copyTemplate(rl, targetDir) {
+    let policy = null;
+    let rememberedOverwrite = false;
+    const skipped = new Set();
+
+    async function resolveConflict(relativePath) {
+        let overwrite;
+        if (policy === "reuse") {
+            overwrite = rememberedOverwrite;
+        } else {
+            overwrite = await askYesNo(rl, promptOverwrite(relativePath));
+            if (policy === null) {
+                rememberedOverwrite = overwrite;
+                policy = await askConflictPolicy(rl);
+            }
+        }
+        return overwrite;
+    }
+
+    async function copyNode(sourcePath, destinationPath, relativePath) {
+        const sourceStat = await fs.promises.lstat(sourcePath);
+        let destinationStat = null;
+        try {
+            destinationStat = await fs.promises.lstat(destinationPath);
+        } catch (error) {
+            if (error.code !== "ENOENT") throw error;
+        }
+
+        if (destinationStat) {
+            const sameType = sourceStat.isDirectory() === destinationStat.isDirectory();
+            if (sameType && sourceStat.isDirectory()) {
+                // Merge directories so unrelated user files remain untouched.
+            } else if (!(await resolveConflict(relativePath))) {
+                skipped.add(relativePath);
+                return;
+            } else {
+                await fs.promises.rm(destinationPath, { recursive: true, force: true });
+                destinationStat = null;
+            }
+        }
+
+        if (sourceStat.isDirectory()) {
+            await fs.promises.mkdir(destinationPath, { recursive: true });
+            const children = await fs.promises.readdir(sourcePath);
+            for (const child of children) {
+                if (child === ".DS_Store") continue;
+                await copyNode(
+                    path.join(sourcePath, child),
+                    path.join(destinationPath, child),
+                    path.posix.join(relativePath, child),
+                );
+            }
+            return;
+        }
+
+        if (sourceStat.isSymbolicLink()) throw new Error(`The template contains an unsupported symbolic link: ${relativePath}`);
+        await fs.promises.mkdir(path.dirname(destinationPath), { recursive: true });
+        await fs.promises.copyFile(sourcePath, destinationPath);
+        await fs.promises.chmod(destinationPath, sourceStat.mode);
+    }
+
+    const children = await fs.promises.readdir(TEMPLATE_DIR);
+    for (const child of children) {
+        if (child === ".DS_Store") continue;
+        await copyNode(path.join(TEMPLATE_DIR, child), path.join(targetDir, child), child);
+    }
+    return skipped;
+}
+
+async function installDependencies(targetDir) {
+    console.log("\nInstalling dependencies with Yarn...");
+    const result = spawnSync("yarn", ["install"], { cwd: targetDir, stdio: "inherit", shell: process.platform === "win32" });
+    if (result.error || result.status !== 0) {
+        console.error("\nProject files were created, but Yarn could not complete the installation.");
+        console.error("Install Yarn if needed, then run 'yarn install' from the project folder.");
+        return false;
+    }
+    return true;
+}
+
+async function main() {
+    if (!fs.existsSync(TEMPLATE_DIR)) throw new Error("The project template could not be found in this installation.");
+
+    const rl = readline.createInterface({ input: stdin, output: stdout });
+    try {
+        const answers = await collectAnswers(rl);
+        const targetDir = path.resolve(process.cwd(), answers.workspaceName);
+        const existing = await fs.promises.lstat(targetDir).catch((error) => {
+            if (error.code === "ENOENT") return null;
+            throw error;
+        });
+
+        if (existing && !existing.isDirectory()) {
+            throw new Error(`A file already exists at "${answers.workspaceName}". Choose a different workspace folder name.`);
+        }
+
+        if (existing) {
+            const proceed = await askYesNo(
+                rl,
+                `The workspace folder "${answers.workspaceName}" already exists. Should I add the project files to it? [y/N]: `,
+            );
+            if (!proceed) {
+                console.log("Project creation cancelled.");
+                return;
+            }
+        }
+
+        await fs.promises.mkdir(targetDir, { recursive: true });
+        answers.skipped = await copyTemplate(rl, targetDir);
+        await writeCustomizedFiles(targetDir, answers);
+        rl.close();
+
+        const installed = await installDependencies(targetDir);
+        if (installed) {
+            console.log("\nSetup complete. Start your project with 'yarn start'.");
+        } else {
+            console.log(`\nProject files are ready in "${answers.workspaceName}".`);
+        }
+    } finally {
+        rl.close();
+    }
+}
+
+main().catch((error) => {
+    console.error(`\nProject creation failed: ${error.message}`);
+    process.exitCode = 1;
+});

package/package.json

@@ -1,6 +1,18 @@
 {
   "name": "@bariskuran/create-base",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.2",
+  "description": "Create a project with @bariskuran/base.",
+  "license": "MIT",
+  "author": "Baris Kuran",
+  "bin": {
+    "create-base": "bin/create-base.cjs"
+  },
+  "files": [
+    "bin/create-base.cjs",
+    "template",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=23.0.0"
+  }
+}

package/template/.env

@@ -0,0 +1,5 @@
+VITE_ENABLE_DESIGN_SYSTEM=false
+VITE_SITE_TITLE=[PROJECT_TITLE]
+VITE_SITE_DESCRIPTION=[PROJECT_DESCRIPTION]
+VITE_SITE_URL=[PROJECT_URL]
+VITE_DEVELOPER_NAME=[DEVELOPER_NAME]

package/template/.gitattributes

@@ -0,0 +1,2 @@
+# Auto detect text files and perform LF normalization
+* text=auto

package/template/.node-version

@@ -0,0 +1 @@
+23.0.0

package/template/.nvmrc

@@ -0,0 +1 @@
+23.0.0

package/template/.prettierrc.json

@@ -0,0 +1,7 @@
+{
+    "trailingComma": "all",
+    "tabWidth": 4,
+    "semi": true,
+    "singleQuote": false,
+    "printWidth": 120
+}

package/template/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) [YEAR] [DEVELOPER_NAME] / [DEVELOPER_CONTACT]
+
+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/template/builder.cjs

@@ -0,0 +1,144 @@
+/* eslint-disable no-undef */
+const { execFileSync, execSync } = require("child_process");
+const path = require("path");
+
+const MODE = process.argv[2]; // useGitBase | useLocalBase | buildLocal | buildRegistry
+const PKG_NAME = "@bariskuran/base";
+const BASE_SPEC = process.env.BASE_SPEC || `${PKG_NAME}@0.0.2`;
+
+function run(cmd) {
+    execSync(cmd, { stdio: "inherit" });
+}
+
+function runNodeScript(scriptPath) {
+    execFileSync(process.execPath, [scriptPath], { stdio: "inherit" });
+}
+
+function runVite(args) {
+    execFileSync(process.execPath, [path.join("node_modules", "vite", "bin", "vite.js"), ...args], {
+        stdio: "inherit",
+    });
+}
+
+function runSilent(cmd) {
+    try {
+        execSync(cmd, { stdio: "ignore" });
+        return true;
+    } catch {
+        return false;
+    }
+}
+
+function startViteDev() {
+    runVite([]);
+}
+
+function buildVite() {
+    runVite(["build"]);
+}
+
+function formatRouteFiles() {
+    execFileSync(
+        process.execPath,
+        [path.join("node_modules", "prettier", "bin", "prettier.cjs"), "--write", "src/views/**/route.js"],
+        { stdio: "inherit" },
+    );
+}
+
+function generateRouteMetadata() {
+    runNodeScript("routes_auto_fill.cjs");
+    formatRouteFiles();
+}
+
+function ensureGitBaseInstalled() {
+    runSilent(`yarn unlink "${PKG_NAME}"`);
+    run(`yarn add "${BASE_SPEC}"`);
+}
+
+function switchToLocalLink() {
+    runSilent(`yarn remove "${PKG_NAME}"`);
+    run(`yarn link "${PKG_NAME}"`);
+}
+
+function usageAndExit() {
+    process.exit(1);
+}
+
+function assertSupportedNode() {
+    const [major] = process.versions.node.split(".").map(Number);
+    const isSupported = major >= 23;
+
+    if (!isSupported) {
+        console.error(
+            `Node ${process.versions.node} is too old for this project. Use Node >=23.0.0, then rerun this command.`,
+        );
+        process.exit(1);
+    }
+}
+
+if (!MODE) usageAndExit();
+
+assertSupportedNode();
+
+if (MODE === "useGitBase") {
+    console.log(`🔁 Using GIT/registry base: ${BASE_SPEC}`);
+    ensureGitBaseInstalled();
+    console.log("🚀 Starting Vite dev server…");
+    startViteDev();
+    process.exit(0);
+}
+
+if (MODE === "useLocalBase") {
+    console.log("🔁 Switching to LOCAL linked base…");
+    switchToLocalLink();
+    console.log("🚀 Starting Vite dev server…");
+    startViteDev();
+    process.exit(0);
+}
+
+if (MODE === "buildLocal") {
+    console.log("🏗️ Build with LOCAL linked base.");
+
+    let buildSucceeded = false;
+    try {
+        switchToLocalLink();
+        console.log("🧭 Generating route metadata…");
+        generateRouteMetadata();
+        console.log("📦 Running vite build…");
+        buildVite();
+        buildSucceeded = true;
+        console.log("✅ Build completed.");
+    } finally {
+        if (!buildSucceeded) {
+            console.log("⚠️ Build failed; keeping current dependency state.");
+        }
+    }
+
+    process.exit(buildSucceeded ? 0 : 1);
+}
+
+if (MODE === "buildRegistry") {
+    console.log(`🏗️ Build with GIT/registry base: ${BASE_SPEC}`);
+
+    let buildSucceeded = false;
+    try {
+        ensureGitBaseInstalled();
+        console.log("🧭 Generating route metadata…");
+        generateRouteMetadata();
+        console.log("📦 Running vite build…");
+        buildVite();
+        buildSucceeded = true;
+        console.log("✅ Build completed.");
+    } finally {
+        if (buildSucceeded) {
+            console.log("🔁 Switching back to LOCAL linked base…");
+            switchToLocalLink();
+            console.log("✅ Local link enabled.");
+        } else {
+            console.log("⚠️ Build failed; keeping current dependency state (no auto relink).");
+        }
+    }
+
+    process.exit(buildSucceeded ? 0 : 1);
+}
+usageAndExit();

package/template/eslint.config.mjs

@@ -0,0 +1,116 @@
+import { fixupConfigRules, fixupPluginRules } from "@eslint/compat";
+import globals from "globals";
+import js from "@eslint/js";
+import { FlatCompat } from "@eslint/eslintrc";
+
+import react from "eslint-plugin-react";
+import reactHooks from "eslint-plugin-react-hooks";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const compat = new FlatCompat({
+    baseDirectory: path.dirname(fileURLToPath(import.meta.url)),
+    recommendedConfig: js.configs.recommended,
+    allConfig: js.configs.all,
+});
+
+export default [
+    {
+        ignores: ["**/dist", "**/.eslintrc.cjs", "**/_notlar.js"],
+    },
+    ...fixupConfigRules(
+        compat.extends(
+            "eslint:recommended",
+            "plugin:react/recommended",
+            "plugin:react/jsx-runtime",
+            "plugin:react-hooks/recommended",
+        ),
+    ),
+    {
+        files: ["**/*.{js,jsx}"],
+        plugins: {
+            react: fixupPluginRules(react),
+            "react-hooks": fixupPluginRules(reactHooks),
+        },
+
+        languageOptions: {
+            globals: {
+                ...globals.browser,
+                process: true,
+            },
+
+            ecmaVersion: "latest",
+            sourceType: "module",
+        },
+
+        settings: {
+            react: {
+                version: "^18.3.1",
+            },
+        },
+
+        rules: {
+            "react-hooks/refs": "off",
+            "react/no-children-prop": "off",
+            "react/no-unescaped-entities": "off",
+            "no-unreachable": "warn",
+            "no-var": "error",
+            "no-undef": "error",
+            "no-unused-vars": "warn",
+            "react-hooks/exhaustive-deps": "off",
+
+            "react/jsx-no-undef": [
+                "error",
+                {
+                    allowGlobals: true,
+                },
+            ],
+
+            "react/jsx-curly-brace-presence": [
+                "error",
+                {
+                    children: "ignore",
+                    props: "never",
+                },
+            ],
+
+            "react/jsx-no-bind": [
+                "error",
+                {
+                    allowArrowFunctions: true,
+                },
+            ],
+
+            "react/jsx-no-literals": "off",
+            "react/jsx-no-target-blank": "off",
+            "react/no-deprecated": "off",
+            "react/prop-types": "off",
+            "prettier/prettier": "off",
+            "require-await": "error",
+            "space-before-function-paren": "off",
+            "no-prototype-builtins": "warn",
+            "react/jsx-runtime": "off",
+            "react/jsx-filename-extension": [0],
+        },
+    },
+    {
+        files: ["**/.eslintrc.{js,cjs}"],
+
+        languageOptions: {
+            globals: {
+                ...globals.node,
+                process: true,
+            },
+
+            ecmaVersion: 5,
+            sourceType: "commonjs",
+        },
+    },
+    {
+        files: ["**/*.js"],
+        rules: {
+            // ❌ JSX is forbidden in .js files
+            "react/jsx-filename-extension": ["error", { extensions: [".jsx"] }],
+        },
+    },
+];

package/template/index.html

@@ -0,0 +1,29 @@
+<!doctype html>
+<html lang="en">
+    <head>
+        <meta property="og:type" content="website" />
+        <meta charset="utf-8" />
+        <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no" />
+        <meta name="author" content="%VITE_DEVELOPER_NAME%" />
+
+        <title>%VITE_SITE_TITLE%</title>
+        <meta property="og:title" content="%VITE_SITE_TITLE%" />
+        <meta name="description" content="%VITE_SITE_DESCRIPTION%" />
+        <meta property="og:description" content="%VITE_SITE_DESCRIPTION%" />
+
+        <meta property="og:image" content="%VITE_SITE_URL%/og-cover.jpg?v=2" />
+        <meta property="og:image:width" content="1200" />
+        <meta property="og:image:height" content="630" />
+
+        <meta name="twitter:card" content="summary_large_image" />
+
+        <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+        <link rel="preconnect" href="https://fonts.googleapis.com" />
+        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+    </head>
+
+    <body>
+        <div id="root"></div>
+        <script type="module" src="/src/main.jsx"></script>
+    </body>
+</html>

package/template/jsconfig.json

@@ -0,0 +1,38 @@
+{
+    "compilerOptions": {
+        "target": "ES2020",
+        "module": "ESNext",
+        "lib": ["ES2020", "DOM", "DOM.Iterable"],
+        "jsx": "react-jsx",
+        "moduleResolution": "bundler",
+        "allowJs": true,
+        "checkJs": false,
+        "strict": false,
+        "esModuleInterop": true,
+        "skipLibCheck": true,
+        "forceConsistentCasingInFileNames": true,
+        "resolveJsonModule": true,
+        "isolatedModules": true,
+        "noEmit": true,
+        "paths": {
+            "base": ["./node_modules/@bariskuran/base"],
+            "global": ["./src/global"],
+            "global/*": ["./src/global/*"],
+            "components": ["./src/components"],
+            "components/*": ["./src/components/*"],
+            "images": ["./src/images"],
+            "images/*": ["./src/images/*"],
+            "views": ["./src/views"],
+            "views/*": ["./src/views/*"],
+            "hooks": ["./src/hooks"],
+            "hooks/*": ["./src/hooks/*"],
+            "functions": ["./src/functions"],
+            "functions/*": ["./src/functions/*"],
+            "assets": ["./src/assets"],
+            "assets/*": ["./src/assets/*"]
+        },
+        "typeRoots": ["./node_modules/@types"]
+    },
+    "include": ["src/**/*"],
+    "exclude": ["node_modules", "dist"]
+}

package/template/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "[PROJECT_NAME]",
+  "description": "[PROJECT_DESCRIPTION]",
+  "author": "[DEVELOPER_NAME] <[DEVELOPER_CONTACT]>",
+  "private": false,
+  "version": "0.1.0",
+  "license": "MIT",
+  "engines": {
+    "node": ">=23.0.0"
+  },
+  "scripts": {
+    "start:original": "vite",
+    "build:original": "vite build",
+    "start": "node builder.cjs useGitBase",
+    "start:local": "node builder.cjs useLocalBase",
+    "build": "node builder.cjs buildRegistry",
+    "build:local": "node builder.cjs buildLocal",
+    "autoFill": "node routes_auto_fill.cjs && prettier --write \"src/views/**/route.js\"",
+    "images:index": "node node_modules/@bariskuran/base/src/libs/createImageCatalog/tools/base-image-index.cjs"
+  },
+  "dependencies": {
+    "antd": "^6.3.0",
+    "react": "19.2.3",
+    "react-dom": "19.2.3",
+    "react-router-dom": "7.12.0",
+    "styled-components": "^6.3.8",
+    "@bariskuran/base": "0.0.2"
+  },
+  "devDependencies": {
+    "@eslint/compat": "2.0.1",
+    "@eslint/eslintrc": "3.3.0",
+    "@eslint/js": "9.39.2",
+    "@vitejs/plugin-react": "5.1.2",
+    "eslint": "9.39.2",
+    "eslint-plugin-import": "2.32.0",
+    "eslint-plugin-react": "7.37.5",
+    "eslint-plugin-react-hooks": "7.0.1",
+    "globals": "17.0.0",
+    "prettier": "3.8.1",
+    "react-syntax-highlighter": "16.1.0",
+    "vite": "7.3.1",
+    "vite-plugin-eslint": "1.8.1"
+  },
+  "resolutions": {
+    "browserslist": "4.28.1",
+    "caniuse-lite": "1.0.30001765"
+  },
+  "proxy": "http://localhost:3000"
+}

package/template/public/favicon.svg

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg id="Layer_1" xmlns="http://www.w3.org/2000/svg" version="1.1" viewBox="0 0 64 64">
+  <!-- Generator: Adobe Illustrator 30.8.2, SVG Export Plug-In . SVG Version: 2.1.4 Build 7)  -->
+  <defs>
+    <style>
+      .st0 {
+        fill: #2c2a29;
+      }
+    </style>
+  </defs>
+  <circle class="st0" cx="32" cy="32" r="26.06"/>
+</svg>

package/template/src/App.jsx

@@ -0,0 +1,8 @@
+import { Base, createImageCatalog } from "base";
+import { PROJECT_SETTINGS } from "global/PROJECT_SETTINGS";
+import imageCatalog from "./imageCatalog";
+
+createImageCatalog(imageCatalog);
+
+const App = () => <Base projectSettings={PROJECT_SETTINGS} />;
+export default App;

package/template/src/components/Layout/NavigationContext.jsx

@@ -0,0 +1,5 @@
+import { createContext, useContext } from "react";
+
+export const NavigationContext = createContext(null);
+
+export const useNavigationContext = () => useContext(NavigationContext);

package/template/src/components/Layout/index.jsx

@@ -0,0 +1,17 @@
+import { Outlet, ScrollBar, Suspense } from "base";
+import { NavigationContext } from "./NavigationContext";
+import { SuspenceFallback } from "../SuspenceFallback";
+
+export const Layout = () => {
+    /* Return */
+    return (
+        <span style={{ display: "contents" }}>
+            <ScrollBar.primary body maxLength={40} fillMode />
+            <NavigationContext.Provider value={{}}>
+                <Suspense fallback={<SuspenceFallback />}>
+                    <Outlet />
+                </Suspense>
+            </NavigationContext.Provider>
+        </span>
+    );
+};

package/template/src/components/SuspenceFallback/index.jsx

@@ -0,0 +1,16 @@
+import { styled, t } from "base";
+
+const S = {
+    suspenseContainer: styled.div`
+        width: 100%;
+        min-height: 100vh;
+        background: black;
+        color: white;
+        display: flex;
+        position: relative;
+        align-items: center;
+        justify-content: center;
+    `,
+};
+
+export const SuspenceFallback = () => <S.suspenseContainer>{t("loading")}</S.suspenseContainer>;

package/template/src/global/ICONS_LIBRARY.js

@@ -0,0 +1,31 @@
+/**
+ * Icon library definition used by the Base Design System.
+ *
+ * Each icon entry is defined as a tuple with **three fixed positions**:
+ *
+ * `[0] viewBox` SVG viewBox value. **Consistency rule:** width **or** height MUST be max `20`
+ * `[1] svgPath` SVG `<path d="...">` definition. No `<svg>` wrapper
+ * `[2] searchKeywords` (optional) Keywords used **only for search / filtering** in development tools.
+ * - Used by `localhost:3000/baseDesignSystem/icons` explorer
+ *
+ * ```js
+ * import { Icon } from "base";
+ * <Icon icon="arrowDown" width={16} />
+ * ```
+ *
+ * ### `<Icon />` Props
+ *
+ * @param {string} icon - Icon name (key of ICONS_LIBRARY)
+ * @param {number} [width=10] - Icon width (height auto-calculated unless `useHeight` is true)
+ * @param {string} [color] - Icon color (defaults to theme foreground color)
+ * @param {string} [onHoverColor] - Color applied on hover
+ * @param {Object} [style] - Inline style object
+ * @param {boolean} [useHeight=false] - Uses height instead of width for scaling
+ */
+export const ICONS_LIBRARY = {
+    // example: [
+    //     "20 20",
+    //     "d",
+    //     ["logo"],
+    // ],
+};

package/template/src/global/PROJECT_SETTINGS.jsx

@@ -0,0 +1,169 @@
+import { ICONS_LIBRARY } from "./ICONS_LIBRARY";
+import { css } from "base";
+import { TEXT_LIBRARY } from "./TEXT_LIBRARY";
+import { SuspenceFallback } from "components/SuspenceFallback";
+import { Layout } from "components/Layout";
+import { SITEMAP } from "./SITEMAP";
+
+export const PROJECT_SETTINGS = {
+    SuspenseFallback: <SuspenceFallback />,
+    /** Text Library */
+    textLibrary: TEXT_LIBRARY,
+
+    /** RRD Settings */
+    rrdSettings: {
+        Layout: Layout,
+        SITEMAP: SITEMAP,
+        overridePrepareRoutes: null,
+    },
+
+    // languageSettings
+    languageSettings: {
+        defaultLanguage: "tr",
+        ignoreClientLanguage: true,
+        languageList: ["tr", "en"],
+    },
+
+    // baseDateSettings
+    baseDateSettings: {
+        disable: false,
+        defaultFormat: "|DD|-|MM|-|YYYY|",
+        defaultTimeZone: "UTC",
+        firstDayOfWeek: 1, // monday
+    },
+
+    // iconsLibrary
+    iconsLibrary: ICONS_LIBRARY,
+
+    // idleManagerSettings
+    idleManagerSettings: {
+        enabled: true,
+        allowedIdleTime: 30, // mins
+        onIdle: () => {
+            console.log("onIdle");
+        },
+        onActive: () => {
+            console.log("onActive");
+        },
+    },
+
+    // notifierManager Settings
+    notifierSettings: {
+        killAfter: 5, // secs
+        // disableNotifier: true,
+        // disableAutoKill: true,
+        closingDelay: 0.5, // secs
+    },
+
+    // Suspence Settings
+    otherSuspenseProps: {},
+
+    // baseFetch Settings
+    baseFetchSettings: {
+        disableApiLoading: false,
+        disableAuth: true,
+        getTokenFrom: () => {},
+        token: null,
+        cacheTime: 10, // mins
+    },
+
+    // styledComponents Settings
+    styledSettings: {
+        // breakpoints,
+        //maxAspRatio,
+        //minAspRatio,
+        //remSettings,
+        fonts: {
+            primaryFont: css`
+                @import url("https://fonts.googleapis.com/css2?family=Montserrat:wght@300;400;500;700&display=swap");
+                font-family: "Montserrat", sans-serif !important;
+                font-size: 14rem;
+                font-weight: 400;
+                line-height: 1.75;
+            `,
+            openSans: css`
+                @import url("https://fonts.googleapis.com/css2?family=Open+Sans:wght@300;400;500;700&display=swap");
+                font-family: "Open Sans", sans-serif !important;
+                font-size: 14rem;
+                font-weight: 400;
+                line-height: 1.75;
+            `,
+        },
+        globalStyle: css`
+            html,
+            body {
+                margin: 0;
+                height: auto;
+                min-height: 100vh;
+            }
+
+            #root {
+                width: 100%;
+                height: auto;
+                min-height: 100vh;
+                overflow: unset;
+                display: flex;
+                flex-direction: column;
+                align-items: flex-start;
+                justify-content: flex-start;
+            }
+        `,
+        themes: {
+            light: {
+                _props: {
+                    isDefault: true,
+                    label: { tr: "Açık Tonlar", en: "Light Theme" },
+                },
+                background: "#E0E0E0",
+                foreground: "#17181c",
+                grey: "#3A3A3A",
+                primary: "#ff6f00",
+                secondary: "#305664",
+                error: "#803939",
+                success: "#146314",
+                warning: "#7C5A07",
+            },
+            dark: {
+                _props: {
+                    label: { tr: "Koyu Tonlar", en: "Dark Theme" },
+                },
+                background: "#17181c",
+                foreground: "#E0E0E0",
+                primary: "#ffbf00",
+                secondary: "#305A7A",
+            },
+        },
+        makeAntdTheme: (t) => ({
+            token: {
+                colorPrimary: t.primary,
+                colorSuccess: t.success,
+                colorWarning: t.warning,
+                colorError: t.error,
+
+                colorText: t.foreground,
+                colorTextBase: t.foreground,
+
+                colorBgBase: t.background,
+                colorBgContainer: t.background,
+                colorBorder: t.grey,
+            },
+        }),
+    },
+
+    // BaseForm Settings
+    baseFormSettings: {
+        HelperComponent: null,
+        helperMode: "auto", // auto, enabled, disabled -- default is auto
+    },
+
+    // Validation Rules
+    validationRules: {},
+
+    // Default Variants
+    defaultVariants: {},
+
+    // adminSettings
+    adminSettings: {
+        showInternalDs: true, // allows to show internal ds in development. // to enable it externally, set .env VITE_ENABLE_DESIGN_SYSTEM=true
+    },
+};

package/template/src/global/SITEMAP.js

@@ -0,0 +1,26 @@
+import Home from "views/home/_route";
+
+export const SITEMAP = [Home];
+
+const flattenRoutes = (routes) =>
+    routes.flatMap((route) => {
+        const childRoutes = route.children ? flattenRoutes(route.children) : [];
+        return route.handle?.id ? [route, ...childRoutes] : childRoutes;
+    });
+
+const createRouteMapById = (routes) =>
+    flattenRoutes(routes).reduce((acc, route) => {
+        if (!acc[route.handle.id]) acc[route.handle.id] = route;
+        return acc;
+    }, {});
+
+export const ROUTE_BY_ID = createRouteMapById(SITEMAP);
+
+export const ROUTE_HANDLE_BY_ID = Object.fromEntries(
+    Object.entries(ROUTE_BY_ID).map(([id, route]) => [id, route.handle]),
+);
+
+export const getRouteHandlesByIds = (ids) => {
+    if (!ids) return null;
+    return ids.map((id) => ROUTE_HANDLE_BY_ID[id]).filter(Boolean);
+};

package/template/src/global/TEXT_LIBRARY.js

@@ -0,0 +1,6 @@
+export const TEXT_LIBRARY = {
+    // back: {
+    //     tr: "GERİ",
+    //     en: "Back",
+    // },
+};

package/template/src/imageCatalog/_placeholder/index.js

@@ -0,0 +1,65 @@
+// Auto Generated by `yarn images:index`
+import thumb from "./thumb.webp";
+import small from "./small.webp";
+import large from "./large.webp";
+import ultra from "./ultra.webp";
+
+const image = {
+    alt: "",
+    keywords: [],
+
+    // Auto Generated by `yarn images:index`
+    shape: "portrait",
+    imageSet: {
+        "thumb": {
+            key: "thumb",
+            src: thumb,
+            naturalWidth: 320,
+            naturalHeight: 213,
+            aRatio: 1.5,
+            type: "image/webp",
+            sizeBytes: 780,
+            sizeKBytes: 0.76,
+            sizeMBytes: 0.001,
+            shape: "landscape",
+        },
+        "small": {
+            key: "small",
+            src: small,
+            naturalWidth: 640,
+            naturalHeight: 1137,
+            aRatio: 0.6,
+            type: "image/webp",
+            sizeBytes: 2640,
+            sizeKBytes: 2.58,
+            sizeMBytes: 0.003,
+            shape: "portrait",
+        },
+        "large": {
+            key: "large",
+            src: large,
+            naturalWidth: 1138,
+            naturalHeight: 2024,
+            aRatio: 0.6,
+            type: "image/webp",
+            sizeBytes: 6614,
+            sizeKBytes: 6.46,
+            sizeMBytes: 0.006,
+            shape: "portrait",
+        },
+        "ultra": {
+            key: "ultra",
+            src: ultra,
+            naturalWidth: 2699,
+            naturalHeight: 4048,
+            aRatio: 0.7,
+            type: "image/webp",
+            sizeBytes: 25572,
+            sizeKBytes: 24.97,
+            sizeMBytes: 0.024,
+            shape: "portrait",
+        }
+    }
+};
+
+export default image;

package/template/src/imageCatalog/index.js

@@ -0,0 +1,3 @@
+// Auto Generated by `yarn images:index`
+
+export default {};

package/template/src/main.jsx

@@ -0,0 +1,3 @@
+import ReactDOM from "react-dom/client";
+import App from "./App.jsx";
+ReactDOM.createRoot(document.getElementById("root")).render(<App />);

package/template/src/views/home/_route.js

@@ -0,0 +1,11 @@
+import { lazy } from "base";
+const Component = lazy(() => import("./index.jsx"));
+
+const title = {
+    tr: "",
+    en: "",
+};
+const path = { tr: "/", en: "/" };
+
+const route = { Component, path, handle: { isHome: true, title, path } };
+export default route;

package/template/src/views/home/_styled.js

@@ -0,0 +1,6 @@
+import { styled } from "base";
+
+const S = {
+    container: styled.div``,
+};
+export default S;

package/template/src/views/home/index.jsx

@@ -0,0 +1,5 @@
+const Home = () => {
+    /* Return */
+    return <div>Hello World!</div>;
+};
+export default Home;

package/template/vite.config.mjs

@@ -0,0 +1,112 @@
+/* global console */
+
+// vite.config.mjs
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import eslint from "vite-plugin-eslint";
+import { bariskuranBaseAliases, bariskuranBaseResolvePlugin } from "@bariskuran/base/vite";
+import { fileURLToPath } from "url";
+import path from "path";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const baseSourceRoot = path.resolve(__dirname, "../base/src");
+
+const isBaseModule = (id = "") => id.startsWith(baseSourceRoot);
+const isImage = (name = "") => /\.(avif|gif|jpe?g|png|svg|webp)$/i.test(name);
+
+const getAssetSourceNames = (asset) => [
+    ...(asset.originalFileNames || []),
+    ...(asset.names || []),
+    asset.name || "",
+];
+
+export default defineConfig(({ command }) => ({
+    test: {
+        environment: "jsdom",
+        setupFiles: "./vitest.setup.js",
+        globals: true,
+        restoreMocks: true,
+        clearMocks: true,
+        mockReset: true,
+    },
+
+    resolve: {
+        dedupe: ["react", "react-dom", "react-router-dom", "styled-components"],
+        extensions: [".mjs", ".js", ".jsx", ".json"],
+        alias: {
+            base: "@bariskuran/base",
+            ...bariskuranBaseAliases(),
+            src: "/src",
+            global: "/src/global",
+            components: "/src/components",
+            images: "/src/images",
+            views: "/src/views",
+            hooks: "/src/hooks",
+            functions: "/src/functions",
+            assets: "/src/assets",
+        },
+    },
+
+    server: {
+        host: true, // networkte erişilebilir hale getirir
+        port: 3000,
+        sourcemapIgnoreList: false, // Tüm dosyaları source map'te göster
+    },
+
+    // Development için detaylı source map
+    css: {
+        devSourcemap: true,
+    },
+
+    plugins: [
+        bariskuranBaseResolvePlugin(),
+        react({
+            jsxRuntime: "automatic",
+        }),
+        eslint({
+            include: [`${path.resolve(__dirname, "")}/**/*.{js,jsx}`],
+        }),
+    ],
+
+    optimizeDeps: {
+        force: true,
+        exclude: ["_backUp/*"],
+    },
+
+    // Inline maps are useful in development but add the full source map to every
+    // production JavaScript file.
+    esbuild: {
+        jsx: "automatic",
+        sourcemap: command === "serve" ? "inline" : false,
+    },
+
+    build: {
+        sourcemap: true, // Build için source map
+        minify: "esbuild",
+        rollupOptions: {
+            output: {
+                entryFileNames: "chunks/[name]-[hash].js",
+                chunkFileNames: (chunk) => {
+                    const moduleIds = chunk.moduleIds || [];
+                    const isBaseChunk = moduleIds.length > 0 && moduleIds.every(isBaseModule);
+
+                    return isBaseChunk ? "base/[name]-[hash].js" : "chunks/[name]-[hash].js";
+                },
+                assetFileNames: (asset) => {
+                    const sourceNames = getAssetSourceNames(asset);
+
+                    if (sourceNames.some(isBaseModule)) {
+                        return "base/[name]-[hash][extname]";
+                    }
+
+                    if (sourceNames.some(isImage)) {
+                        return "images/[name]-[hash][extname]";
+                    }
+
+                    return "chunks/[name]-[hash][extname]";
+                },
+            },
+        },
+    },
+}));