Package Exports
- @techliftdigital/tld-cli
Readme
🚀 TechLift Digital CLI ─ Enterprise Suite Engine
Tech-Stack: Next.js 15+ | Next-Auth@Beta | Shadcn UI | MongoDB | Bcrypt | pnpm
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. Designed to deploy Next.js 16+, Shadcn UI, Next-Auth v5, and MongoDB architectures instantly.
📋 Available Commands & Usage
| Command | Args | Options | Description |
|---|---|---|---|
welcome |
N/A | N/A | (Default) Interactive full-screen dashboard displaying stack breakdown and command legends. |
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 limits for standard 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 localpnpm devserver immediately after the deployment sequence completes.
💡 Example Commands
```bash
Standard interactive deployment
tld create-app my-workspace ./
Express deployment (Bypass prompts)
tld create-app internal-dash ./ -f
Express deployment + Auto-start Next.js server on finish
tld create-app prod-portal ./ -f -r ```
🏗️ Core Implementation Details
1. Framework Scaffolding
- Uses
npx create-next-app@latestwith:- TypeScript, ESLint, Tailwind CSS, App Router.
--use-pnpmenforced for performance.--no-src-dir&--import-alias "@/*".
2. Full-Stack Driver Injection
- Automated
pnpm addfor:next-auth@beta,mongodb(native),bcrypt.@types/bcrypt(dev-dependency).
3. Next-Auth@Beta (Auth.js v5) Architecture
To prevent Edge Runtime errors in Next.js 16+, the CLI implements Runtime Separation Architecture:
auth.config.ts: Contains pure, Edge-compatible configuration.auth.ts: Full Node.js initialization (exportsauth,signIn,signOut).proxy.ts: Dedicated Edge Middleware Proxy. UsesNextAuth(authConfig).authdirectly to remain lightweight and compatible with the Edge runtime./app/api/auth/[...nextauth]/route.ts: Standardized API route handlers..env.local: Automatically generates and injects a secureAUTH_SECRET.
4. Design System Registry
shadcn init: Automated initialization.shadcn add --all: Populates the project with the entire official shadcn component registry for immediate UI development.
5. Production-Grade Database Configuration
lib/mongodb.ts: Automatically scaffolds the official Vercel/MongoDB singleton architectural pattern to handle Hot Module Replacements without connection drain.- Environment Automation: Directly configures
MONGODB_URIconnection strings securely alongside NextAuth details within.env.local.
💖 Support the Suite
If the TechLift Digital CLI has accelerated your enterprise engineering, consider supporting our mission to modernize full-stack development through high-performance automation.
🎨 Visual & Technical Features
- Live Non-Blocking execution: Tasks stream
stdoutdirectly into the UI spinner with duration timers to guarantee loaders never freeze, even during massive installations. - Automatic Update Notifier: Evaluates registry distribution tags asynchronously and alerts the developer if a newer version of the CLI is published.
- Mathematical Centering: Logo and UI components are centered row-by-row based on
process.stdout.columns. - Adaptive Stacking: Branding logo (TECHLIFT DIGITAL) automatically stacks vertically on narrow terminals to prevent layout breakage.
- Context-Aware Error Handling: Step-specific Try/Catch blocks with prescriptive "💡 Tips" for resolution.
- Premium Themes: Uses
gradient-string(Blue-to-Cyan).
🔧 Installation & Contribution
- Ensure
node(Checktld doctor) andpnpmare in your PATH. - Clone the repository and run
pnpm install. - Executable:
node index.js.
TechLift Digital ─ Engineering Your Vision.
Official Portal