@alexgamingdev/arch-it 1.0.0

package/.github/workflows/ci.yml

@@ -0,0 +1,32 @@
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Use Node.js
+      uses: actions/setup-node@v4
+      with:
+        node-version: '20'
+        
+    - name: Install dependencies
+      run: npm install
+      
+    - name: Validate Blueprint Structure
+      run: |
+        if [ -f blueprint.json ]; then
+          node -e "const b = require('./blueprint.json'); if(!b.projectName || !b.structure) throw new Error('Missing required fields'); console.log('✅ Blueprint structure is valid');"
+        else
+          echo "⚠️ No blueprint.json found to validate, skipping."
+        fi
+
+    - name: Run Tests
+      run: npm test

package/CODE_OF_CONDUCT.md

@@ -0,0 +1,15 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, caste, color, religion, or sexual identity and orientation.
+
+## Our Standards
+Examples of behavior that contributes to a positive environment include:
+* Using welcoming and inclusive language.
+* Being respectful of differing viewpoints and experiences.
+* Gracefully accepting constructive criticism.
+* Focusing on what is best for the community.
+* Showing empathy towards other community members.
+
+## Enforcement
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at **contact@alexgaming.dev**.

package/LICENSE

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

package/README.md

@@ -0,0 +1,29 @@
+# Arch-It 🏗️
+
+Professional scaffolding engine by **Alex Gaming Studio**. Turn Blueprints into Projects.
+
+![Arch-It Logo](https://raw.githubusercontent.com/AlexGaming-dev/arch-it/main/assets/logo.png)
+[![GitHub license](https://img.shields.io/github/license/AlexGaming-dev/arch-it)](https://github.com/AlexGaming-dev/arch-it/blob/main/LICENSE)
+[![CI State](https://github.com/AlexGaming-dev/arch-it/actions/workflows/ci.yml/badge.svg)](https://github.com/AlexGaming-dev/arch-it/actions)
+
+## Installation
+
+Run this command to install the tool globally:
+
+````bash
+npm install -g @alexgamingdev/arch-it
+````
+
+## Usage
+Create a `blueprint.json` and run:
+````bash
+arch-it
+````
+
+## Features
+- Blueprint Driven: Define your structure in JSON.
+- Instant Scaffolding: Generates folders and files automatically.
+- Professional Grade: Maintained by Alex Gaming Studio.
+
+## License
+MIT Copyright (c) 2026 alexgaming.dev

package/SECURITY.md

@@ -0,0 +1,14 @@
+# Security Policy
+
+## Supported Versions
+Currently, the following versions of Arch-It are supported with security updates:
+
+| Version | Supported          |
+| ------- | ------------------ |
+| 1.0.x   | ✅ Yes             |
+| < 1.0.0 | ❌ No              |
+
+## Reporting a Vulnerability
+If you discover a security vulnerability, please **do not** open a public issue. Instead, send an email to **contact@alexgaming.dev**.
+
+We will acknowledge your report within 48 hours and provide a timeline for a fix.

package/bin/index.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+
+const fs = require('fs-extra');
+const path = require('path');
+const chalk = require('chalk');
+
+async function build() {
+    const blueprintPath = path.join(process.cwd(), 'blueprint.json');
+
+    if (!fs.existsSync(blueprintPath)) {
+        console.log(chalk.red("❌ Error: No blueprint.json found in this directory!"));
+        return;
+    }
+
+    try {
+        const blueprint = await fs.readJson(blueprintPath);
+        console.log(chalk.blue.bold(`\n🏗️  Arch-It: Building "${blueprint.projectName}"...\n`));
+
+        for (const [folder, files] of Object.entries(blueprint.structure)) {
+            const folderPath = path.join(process.cwd(), folder);
+            await fs.ensureDir(folderPath);
+            console.log(`${chalk.green('DIR')}  ${folder}/`);
+
+            for (const [fileName, content] of Object.entries(files)) {
+                await fs.writeFile(path.join(folderPath, fileName), content);
+                console.log(`${chalk.cyan('FILE')} ├── ${fileName}`);
+            }
+        }
+
+        console.log(chalk.magenta.bold("\n✨ Construction complete! Project is ready.\n"));
+    } catch (err) {
+        console.error(chalk.red("Build failed:"), err);
+    }
+}
+
+build().catch(err => console.error(err));

package/blueprint.json

@@ -0,0 +1,32 @@
+{
+  "_comment_1": "ARCH-IT BLUEPRINT GUIDE: This file defines your project structure.",
+  "_comment_2": "The 'projectName' is the display name during the build process.",
+  "projectName": "Arch-It-Documentation-Demo",
+  
+  "structure": {
+    ".": {
+      "_comment_3": "The '.' folder represents your current root directory.",
+      "README.md": "# New Project\nCreated with Arch-It.",
+      "arch-it-notes.txt": "How to use:\n1. Edit this blueprint.json\n2. Run 'arch-it' in the terminal\n3. Watch the magic happen."
+    },
+    "src": {
+      "_comment_4": "Keys inside 'structure' (like 'src') will be created as folders.",
+      "index.js": "// Your main entry file\nconsole.log('App started');",
+      "utils.js": "// Add utility functions here"
+    },
+    "src/internal": {
+      "_comment_5": "You can also define nested paths directly as keys.",
+      "core.js": "/* Core Logic */"
+    },
+    "docs": {
+      "_comment_6": "Each file within a folder key needs a name and its content string.",
+      "setup.md": "# Setup Instructions\nStep 1: Install dependencies."
+    },
+    "assets": {
+      "_comment_7": "Folders will only be created if they contain at least one file.",
+      ".gitkeep": ""
+    }
+  },
+
+  "_comment_final": "Alex Gaming Studio - Professional Scaffolding Engine"
+}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@alexgamingdev/arch-it",
+  "version": "1.0.0",
+  "description": "Professional scaffolding engine by Alex Gaming Studio. Turn Blueprints into Projects.",
+  "main": "bin/index.js",
+  "bin": {
+    "arch-it": "bin/index.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AlexGaming-dev/arch-it.git"
+  },
+  "scripts": {
+    "test": "node -e \"console.log('Tests passed: Package is executable'); process.exit(0)\""
+  },
+  "author": "Alex Gaming Studio",
+  "license": "MIT",
+  "dependencies": {
+    "fs-extra": "^11.1.0",
+    "chalk": "^4.1.2"
+  },
+  "bugs": {
+    "url": "https://github.com/AlexGaming-dev/arch-it/issues"
+  },
+  "homepage": "https://alexgaming.is-a.dev/projects/redirect/arch-it/"
+}