aethx-starter-admin

A modern, full-featured React + Vite + Tailwind CSS v4 Admin Dashboard template generator.

🚀 Quick Start

Run the scaffolder command in your terminal:

npx aethx-starter-admin my-dashboard

(npm create aethx-starter-admin does not work - npm create <name> only ever resolves a package literally named create-<name>, regardless of this package's bin field. Use npx as shown above.)

Next Steps

cd my-dashboard
npm install
cp .env.example .env   # set VITE_API_BASE_URL to your backend
npm run dev

There's no offline/demo mode - the dashboard expects a real backend at VITE_API_BASE_URL. See the scaffolded project's own README.md for the expected API shape.

✨ Key Features Included

• ⚡️ Vite + React 19 + TypeScript: Blazing fast development server, type-safety, and React Compiler enabled out of the box.
• 🎨 Tailwind CSS v4 + Shadcn-style UI: Clean design system with pre-styled UI components.
• 📊 Interactive Dashboard & Charts: Built-in Recharts data visualization plus a live activity map (react-simple-maps).
• 🔌 Full Admin API Surface: Typed data hooks (src/hooks/useAdminQueries.ts) for users, projects, subscriptions, transformations, files, and integrations - point VITE_API_BASE_URL at your backend and go. (src/constants/mockData.ts ships a small sample dataset for reference, but nothing wires it up automatically.)
• 🏷️ Self-branding: The app name shown in the UI and browser tab is derived from package.json's name field at build time - rename the package, not the source.
• 🔓 No auth wall: The dashboard is reachable immediately, no login/session logic included - add your own auth once you've picked a strategy.
• 📁 Media Management: Folders, access control, upload presets, and Cloudinary import out of the box.
• ⚡️ Framer Motion Animations: Smooth page transitions and UI micro-interactions.
• 🛠 Zustand State Management: Lightweight UI state management.

🛠 Publishing to NPM

To publish this CLI package to npm:

1. Log in to your npm account:

   npm login

2. Publish the package:

   npm publish --access public