🚀 TechLift Digital CLI

The TechLift Digital CLI is an automated full-stack engineering engine. It provides high-performance architectural scaffolding, environment audits, and production-ready deployments for modern enterprise web projects.

Tech Stack

Next.js 16+ (App Router)
Next-Auth@Beta (Auth.js v5)
Shadcn UI (Full Registry)
MongoDB (Native Driver)
Bcrypt (Secure Hashing)
pnpm (High-Performance Package Manager)

📋 Available Commands & Usage

Command	Args	Options	Description
`welcome`	N/A	N/A	(Default) Displays centered Studio GUI dashboard.
`doctor`	N/A	N/A	Performs deep Node.js & pnpm environment audit.
`create-app`	`<id> <path>`	`-y`, `-f`, `-r`	Initializes full-stack Next.js blueprint.

🛠️ `create-app` Required Arguments

id: (Required) Project Workspace ID (e.g. my-new-app).
targetPath: (Required) Destination directory (e.g. ./ for current path).
-y, --yes: Skip confirmation summary for automated build pipelines.
-f, --faster: Instant deployment. Bypasses all interactive UI/framework customization menus for maximum background execution speed.
-r, --run: Auto-run server. Instantly boots the local pnpm dev server immediately after the deployment sequence completes.

🏗️ Core Implementation Details

1. Framework Scaffolding

The CLI uses npx create-next-app@latest with standardized enterprise configurations:

TypeScript, ESLint, Tailwind CSS, App Router.
Enforced pnpm usage for speed and reliability.
Optimized folder structure (--no-src-dir & --import-alias "@/*").

2. Full-Stack Driver Injection

Automated installation of core dependencies:

next-auth@beta
mongodb (native)
bcryptjs
@types/bcryptjs

3. Runtime Separation Architecture

To prevent Edge Runtime errors in Next.js 16+, the CLI implements a bifurcated authentication structure:

auth.config.ts: Pure, Edge-compatible configuration.
auth.ts: Full Node.js initialization (Node.js runtime).
proxy.ts: Dedicated Edge Middleware Proxy.
api/auth/[...nextauth]: Standardized handlers.

4. Design System Registry

Initialization: Automatic shadcn-ui setup.
Automation: One-command injection of the entire official shadcn component registry.

🔧 Installation

bash

# Recommended: Run directly via npx
npx @techliftdigital/tld-cli welcome

# Or for local development
git clone https://github.com/Kishore56578/tld-cli.git
pnpm install
node index.js

🎨 Visual & Technical Features

Mathematical Centering: Logo and UI components are centered dynamically based on terminal dimensions.
Adaptive Stacking: Branding logo stacks vertically on narrow terminals to prevent layout breakage.
Context-Aware Error Handling: Step-specific Try/Catch blocks with prescriptive "💡 Tips".
Premium Themes: Implements gradient-string (Blue-to-Cyan) for a studio-grade experience.

💖 Support the Suite

If the TechLift Digital CLI has accelerated your enterprise engineering, consider supporting our mission to modernize full-stack development.