create-app-ui 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Omobio
+
+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,117 @@
+# create-app-ui
+
+Enterprise React UI boilerplate generator. Ships shared boilerplate plus template overlays so generated apps are ready to run.
+
+## Use with npx (after publish)
+
+```bash
+npx create-app-ui@latest my-app
+```
+
+Non-interactive:
+
+```bash
+npx create-app-ui@latest my-app -y --template admin-portal --no-install
+npx create-app-ui@latest my-app -y --template blank --no-install --no-git
+npx create-app-ui@latest my-app -y --template admin-portal --git --company "Acme Inc"
+```
+
+Templates: `admin-portal`, `blank`.
+
+Then:
+
+```bash
+cd my-app
+npm install
+npm run dev
+```
+
+## Monorepo development
+
+From `ui-platform/create-app-ui`:
+
+```bash
+npm install
+npm run build
+npm link
+create-app-ui my-app
+```
+
+Or from `ui-platform` root:
+
+```bash
+npm run create
+```
+
+## How generation works
+
+1. **Boilerplate** — `boilerplate/react-base` (shared UI, theme, configs)
+2. **Template overlay** — `templates/<template>` (admin-portal or blank)
+3. Placeholder replacement and optional `npm install` / `git init`
+
+In the monorepo, assets live under `ui-platform/`. The published npm package bundles copies of `boilerplate/` and `templates/` next to `dist/`.
+
+## Publish to npm
+
+Prerequisites: [npm account](https://www.npmjs.com/signup), unique package name (`create-app-ui` may already be taken — use a scoped name if needed, e.g. `@your-org/create-app-ui`).
+
+1. Log in:
+
+```bash
+npm login
+```
+
+2. Verify the tarball (includes CLI, boilerplate, templates):
+
+```bash
+cd ui-platform/create-app-ui
+npm run pack:check
+```
+
+3. Publish (first time or new version):
+
+```bash
+npm publish
+```
+
+Scoped public package:
+
+```bash
+npm publish --access public
+```
+
+4. Bump version for updates:
+
+```bash
+npm version patch   # or minor / major
+npm publish
+```
+
+Consumers then run:
+
+```bash
+npx create-app-ui@latest my-app
+```
+
+### If the package name is taken
+
+Edit `package.json` `name` to e.g. `@omobio/create-app-ui`, then:
+
+```bash
+npx @omobio/create-app-ui@latest my-app
+```
+
+## Add a new template
+
+1. Add `../templates/<template-name>/` in the monorepo (overlay files only).
+2. Register it in `src/prompts.ts` and `src/cli-args.ts`.
+3. Rebuild and publish.
+
+## Scripts
+
+| Script | Description |
+|--------|-------------|
+| `npm run build` | Compile TypeScript to `dist/` |
+| `npm run prepare-publish` | Copy boilerplate + templates into this package |
+| `npm run pack:check` | Dry-run `npm pack` |
+| `npm run start` | Run CLI via `tsx` (local dev) |

package/boilerplate/README.md

@@ -0,0 +1,18 @@
+# Shared React boilerplate
+
+`react-base/` is copied into every generated app **before** a template overlay is applied.
+
+## Included
+
+- Vite + TypeScript + Tailwind + ESLint/Prettier
+- `src/components/ui/*` — themed shadcn-style primitives
+- `src/components/data-table.tsx` — TanStack table; icon-only toolbar inside table border (tooltips)
+- `src/config/theme.ts` — single-file design system
+- `src/api/axios.ts` — shared HTTP client
+- `src/app/store.ts` — store bootstrap stub
+- `src/features/auth/` — auth module stub
+- `src/hooks/` — shared hooks
+- `src/routes/` — route table stub
+- `src/lib/`, `src/context/theme-provider.tsx`, `src/styles/`
+
+Templates only add app-specific pages, layouts, navigation, and `App.tsx` / `main.tsx`.

package/boilerplate/react-base/.env.example

@@ -0,0 +1 @@
+VITE_API_BASE_URL=http://localhost:3000/api

package/boilerplate/react-base/README.md

@@ -0,0 +1,3 @@
+# __APP_TITLE__ (admin-portal)
+
+Generated with create-app-ui.

package/boilerplate/react-base/components.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "default",
+  "rsc": false,
+  "tsx": true,
+  "tailwind": {
+    "config": "tailwind.config.ts",
+    "css": "src/styles/globals.css",
+    "baseColor": "slate",
+    "cssVariables": true
+  },
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/lib/utils",
+    "ui": "@/components/ui",
+    "lib": "@/lib",
+    "hooks": "@/hooks"
+  }
+}

package/boilerplate/react-base/eslint.config.js

@@ -0,0 +1,32 @@
+import js from "@eslint/js";
+import globals from "globals";
+import reactHooks from "eslint-plugin-react-hooks";
+import reactRefresh from "eslint-plugin-react-refresh";
+import tseslint from "typescript-eslint";
+
+export default tseslint.config(
+  { ignores: ["dist"] },
+  {
+    extends: [js.configs.recommended, ...tseslint.configs.recommended],
+    files: ["**/*.{ts,tsx}"],
+    languageOptions: {
+      ecmaVersion: 2020,
+      globals: globals.browser,
+    },
+    plugins: {
+      "react-hooks": reactHooks,
+      "react-refresh": reactRefresh,
+    },
+    rules: {
+      ...reactHooks.configs.recommended.rules,
+      "react-refresh/only-export-components": [
+        "warn",
+        { allowConstantExport: true },
+      ],
+      "@typescript-eslint/no-unused-vars": [
+        "warn",
+        { argsIgnorePattern: "^_" },
+      ],
+    },
+  },
+);

package/boilerplate/react-base/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>__APP_TITLE__</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/boilerplate/react-base/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "react-base-boilerplate",
+  "private": true,
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -b && vite build",
+    "preview": "vite preview",
+    "lint": "eslint .",
+    "format": "prettier --write ."
+  },
+  "dependencies": {
+    "@radix-ui/react-accordion": "^1.2.2",
+    "@radix-ui/react-alert-dialog": "^1.1.4",
+    "@radix-ui/react-avatar": "^1.1.1",
+    "@radix-ui/react-checkbox": "^1.1.3",
+    "@radix-ui/react-context-menu": "^2.2.4",
+    "@radix-ui/react-dialog": "^1.1.2",
+    "@radix-ui/react-dropdown-menu": "^2.1.2",
+    "@radix-ui/react-hover-card": "^1.1.4",
+    "@radix-ui/react-label": "^2.1.0",
+    "@radix-ui/react-menubar": "^1.1.4",
+    "@radix-ui/react-navigation-menu": "^1.2.3",
+    "@radix-ui/react-popover": "^1.1.4",
+    "@radix-ui/react-progress": "^1.1.2",
+    "@radix-ui/react-radio-group": "^1.2.2",
+    "@radix-ui/react-scroll-area": "^1.2.2",
+    "@radix-ui/react-select": "^2.1.4",
+    "@radix-ui/react-separator": "^1.1.0",
+    "@radix-ui/react-slider": "^1.2.2",
+    "@radix-ui/react-slot": "^1.1.0",
+    "@radix-ui/react-switch": "^1.1.2",
+    "@radix-ui/react-tabs": "^1.1.2",
+    "@radix-ui/react-toggle": "^1.1.1",
+    "@radix-ui/react-toggle-group": "^1.1.1",
+    "@radix-ui/react-tooltip": "^1.1.6",
+    "@tanstack/react-table": "^8.20.6",
+    "axios": "^1.7.9",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "date-fns": "^3.6.0",
+    "input-otp": "^1.4.1",
+    "lucide-react": "^0.469.0",
+    "react": "^18.3.1",
+    "react-day-picker": "^8.10.1",
+    "react-dom": "^18.3.1",
+    "react-router-dom": "^6.28.1",
+    "recharts": "^3.8.1",
+    "sonner": "^1.7.1",
+    "tailwind-merge": "^2.5.4",
+    "vaul": "^1.1.2"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.17.0",
+    "@types/react": "^18.3.17",
+    "@types/react-dom": "^18.3.5",
+    "@vitejs/plugin-react-swc": "^3.7.2",
+    "autoprefixer": "^10.4.20",
+    "eslint": "^9.17.0",
+    "eslint-plugin-react-hooks": "^5.1.0",
+    "eslint-plugin-react-refresh": "^0.4.16",
+    "globals": "^15.14.0",
+    "postcss": "^8.4.49",
+    "prettier": "^3.4.2",
+    "tailwindcss": "^3.4.16",
+    "typescript": "^5.7.2",
+    "typescript-eslint": "^8.18.2",
+    "vite": "^6.0.5"
+  }
+}

package/boilerplate/react-base/postcss.config.js

@@ -0,0 +1,6 @@
+export default {
+  plugins: {
+    tailwindcss: {},
+    autoprefixer: {},
+  },
+};

package/boilerplate/react-base/prettier.config.js

@@ -0,0 +1,6 @@
+export default {
+  semi: true,
+  singleQuote: false,
+  trailingComma: "all",
+  printWidth: 100,
+};

package/boilerplate/react-base/src/api/axios.ts

@@ -0,0 +1,20 @@
+import axios from "axios";
+import { APP_NAME } from "@/config/constants";
+
+/**
+ * Shared Axios instance — configure base URL and interceptors here.
+ * Set `VITE_API_BASE_URL` in `.env` for your backend.
+ */
+export const apiClient = axios.create({
+  baseURL: import.meta.env.VITE_API_BASE_URL ?? "/api",
+  timeout: 30_000,
+  headers: {
+    "Content-Type": "application/json",
+    "X-Client": APP_NAME,
+  },
+});
+
+apiClient.interceptors.response.use(
+  (response) => response,
+  (error) => Promise.reject(error),
+);

package/boilerplate/react-base/src/app/store.ts

@@ -0,0 +1,13 @@
+/**
+ * Application store setup.
+ * Wire Redux, Zustand, or another state library here.
+ *
+ * Example with Redux Toolkit:
+ *   import { configureStore } from "@reduxjs/toolkit";
+ *   import { authReducer } from "@/features/auth/authSlice";
+ *   export const store = configureStore({ reducer: { auth: authReducer } });
+ */
+
+export type AppStore = Record<string, never>;
+
+export const store: AppStore = {};