@chahuadev/framework

The official core executable framework for Chahuadev.

⏳ Development Journey: This framework is the proud result of 1 full year of dedicated development. What began as a simple concept evolved into a highly advanced, secure, and robust architecture. Every line of code was meticulously crafted to ensure maximum stability and a premium experience for developers.

� Running on Linux / WSL2 (Ubuntu)

First install the required system libraries (one-time setup):

sudo apt-get update && sudo apt-get install -y \
  libnss3 libatk1.0-0 libatk-bridge2.0-0 libcups2 \
  libdrm2 libxkbcommon0 libxcomposite1 libxdamage1 \
  libxrandr2 libgbm1 libasound2

Then run the AppImage:

chmod +x "Chahuadev-Framework.AppImage"
DISPLAY=:0 WAYLAND_DISPLAY=wayland-0 \
  ./"Chahuadev-Framework.AppImage" \
  --appimage-extract-and-run --no-sandbox --disable-gpu

WSL2 tip: Copy to WSL native filesystem first:

# Path after: npm install -g @chahuadev/framework
# (no sudo)
cp ~/.npm-global/lib/node_modules/@chahuadev/framework/bin/Chahuadev-Framework.AppImage /tmp/ChahuadevFramework.AppImage
# (with sudo)
# cp /usr/lib/node_modules/@chahuadev/framework/bin/Chahuadev-Framework.AppImage /tmp/ChahuadevFramework.AppImage
chmod +x /tmp/ChahuadevFramework.AppImage
DISPLAY=:0 WAYLAND_DISPLAY=wayland-0 /tmp/ChahuadevFramework.AppImage \
  --appimage-extract-and-run --no-sandbox --disable-gpu

�🛡️ CRITICAL SECURITY WARNING - FORTRESS PROTECTION

Maximum Security Architecture

• Intelligent OS Routing: Automatically detects and securely isolates platform-specific binaries.
• Strict Execution Boundaries: Prevents unauthorized cross-platform executions and corrupted loads.
• Anti-Hack Protection System: Built-in safeguards against malicious executable swapping.
• Dependency Isolation: Operates securely via standalone binaries without bloating your system.

⚙️ Installation & Usage

Multi-Platform Support: This framework runs seamlessly on Windows (x64, ia32) and Linux (x64). Our system automatically detects your operating system and securely downloads the required binary behind the scenes.

Global Install (Recommended for CLI)

If you want to use the framework from your terminal anywhere on your system:

npm install -g @chahuadev/framework --foreground-scripts --force

When you install:**

1. npm detects your OS and architecture
2. Installs only the required platform-specific package
3. index.js routes to the correct executable

This ensures:

• Minimal disk space usage (only your OS binary)
• No cross-platform conflicts
• Automatic binary selection

Platform Support

| Platform | Architecture | Status | Format | |----------|-------------|--------|--------| | Windows | 64-bit (x64) | Supported | EXE | | Windows | 32-bit (ia32) | Supported | EXE | | Linux | 64-bit (x64) | Supported | AppImage | | macOS | Intel (x64) | Coming Soon | DMG/App | | macOS | Apple Silicon (arm64) | Coming Soon | DMG/App |

Package Structure

@chahuadev/ ├── framework/
│ └── index.js
│ └── install.js
│ └── package.json
│ └── README.md

Troubleshooting

"Command not found: chahuadev-framework"

Make sure you installed globally:

npm install -g @chahuadev/framework --foreground-scripts --force

"Module not found"

If using locally, ensure it's installed:

npm install -g @chahuadev/framework --foreground-scripts --force

"Unsupported platform"

Your OS/architecture combination is not yet supported. Check the Platform Support table above.

License

Non-Commercial & Acceptable Use — See LICENSE.md