@vc-shell/create-vc-app 1.1.99-alpha.2 → 1.1.99-alpha.5

package/dist/templates/base/_package.json

@@ -23,9 +23,9 @@
     "@types/node": "^20.10.5",
     "@typescript-eslint/eslint-plugin": "^7.4.0",
     "@typescript-eslint/parser": "^7.4.0",
-    "@vc-shell/api-client-generator": "^1.1.99-alpha.2",
-    "@vc-shell/release-config": "^1.1.99-alpha.2",
-    "@vc-shell/ts-config": "^1.1.99-alpha.2",
+    "@vc-shell/api-client-generator": "^1.1.99-alpha.5",
+    "@vc-shell/release-config": "^1.1.99-alpha.5",
+    "@vc-shell/ts-config": "^1.1.99-alpha.5",
     "@vitejs/plugin-vue": "^5.2.3",
     "@vue/eslint-config-prettier": "^9.0.0",
     "@vue/eslint-config-typescript": "^13.0.0",
@@ -53,8 +53,8 @@
     "vue-tsc": "^2.2.10"
   },
   "dependencies": {
-    "@vc-shell/config-generator": "^1.1.99-alpha.2",
-    "@vc-shell/framework": "^1.1.99-alpha.2",
+    "@vc-shell/config-generator": "^1.1.99-alpha.5",
+    "@vc-shell/framework": "^1.1.99-alpha.5",
     "@vueuse/core": "^10.7.1",
     "@vueuse/integrations": "^10.7.1",
     "cross-spawn": "^7.0.3",

package/dist/templates/blades/grid/blade.vue

@@ -129,7 +129,7 @@ import {
   useBlade,
 } from "@vc-shell/framework";
 import { use{{EntityName}}List } from "../composables";
-import {{EntityName}}Details from "./{{entity-name}}-details.vue";
+{{DETAILS_BLADE_IMPORT}}
 import { useI18n } from "vue-i18n";
 
 // TODO: Replace with your actual types
@@ -151,7 +151,7 @@ export interface Emits {
 
 defineOptions({
   name: "{{EntityName}}List",
-  url: "/{{entity-name-plural}}",
+  url: "/{{entity-name-list}}",
   notifyType: "{{EntityName}}DeletedDomainEvent",
   isWorkspace: {{isWorkspace}},
   menuItem: {{menuItem}},
@@ -303,16 +303,7 @@ const notfound = {
 };
 
 const onItemClick = (item: { id?: string }) => {
-  openBlade({
-    blade: markRaw({{EntityName}}Details),
-    param: item.id,
-    onOpen() {
-      selectedItemId.value = item.id;
-    },
-    onClose() {
-      selectedItemId.value = undefined;
-    },
-  });
+  {{DETAILS_BLADE_OPEN_ITEM}}
 };
 
 const onHeaderClick = (item: ITableColumns) => {
@@ -320,9 +311,7 @@ const onHeaderClick = (item: ITableColumns) => {
 };
 
 const add{{EntityName}} = () => {
-  openBlade({
-    blade: markRaw({{EntityName}}Details),
-  });
+  {{DETAILS_BLADE_OPEN_NEW}}
 };
 
 const onPaginationClick = async (page: number) => {

package/dist/utils/naming.d.ts

@@ -12,6 +12,7 @@ export interface NamingConfig {
     entityPluralPascal: string;
     entityPluralCamel: string;
     entityPluralKebab: string;
+    entityListKebab: string;
     moduleNamePascal: string;
     moduleNameUpperSnake: string;
 }

package/dist/utils/naming.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../../src/utils/naming.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,WAAW,YAAY;IAE3B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IAGnB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAG5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAG1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CAwBjF;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAgBlF;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAM/F"}
+{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../../src/utils/naming.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,WAAW,YAAY;IAE3B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IAGnB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAG5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAG1B,eAAe,EAAE,MAAM,CAAC;IAGxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CA0BjF;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAiBlF;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAM/F"}

package/dist/utils/register-module.d.ts

@@ -1,6 +1,10 @@
 /**
  * Registers a new module in main.ts by adding import and .use() call
  *
+ * Supports two styles:
+ * 1. Chain style: const app = createApp().use(...).use(router);
+ * 2. Separate style: const app = createApp(); app.use(...); app.use(router);
+ *
  * @param cwd - Current working directory
  * @param moduleName - Module name (e.g., "orders")
  * @param moduleNamePascal - Module name in PascalCase (e.g., "Orders")

package/dist/utils/register-module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"register-module.d.ts","sourceRoot":"","sources":["../../src/utils/register-module.ts"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,OAAO,CAAC,CAqFlB;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,KAAK,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,GAC1D,OAAO,CAAC,OAAO,CAAC,CA2BlB"}
+{"version":3,"file":"register-module.d.ts","sourceRoot":"","sources":["../../src/utils/register-module.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;GAWG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,OAAO,CAAC,CAgHlB;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,KAAK,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,GAC1D,OAAO,CAAC,OAAO,CAAC,CA2BlB"}

package/dist/utils/templates.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Finds the templates directory by searching multiple possible paths.
+ * Works for both src/ and dist/ directory structures.
+ *
+ * @param currentFileUrl - import.meta.url of the calling file
+ * @returns Absolute path to the templates directory
+ * @throws Error if templates directory is not found
+ */
+export declare function findTemplateRoot(currentFileUrl: string): string;
+//# sourceMappingURL=templates.d.ts.map

package/dist/utils/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/utils/templates.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAqB/D"}

package/dist/workflows/create-app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-app.d.ts","sourceRoot":"","sources":["../../src/workflows/create-app.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAOhE,UAAU,gBAAgB;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC;CACf;AAQD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,eAAe,CAAC;CACzB;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAiD3F"}
+{"version":3,"file":"create-app.d.ts","sourceRoot":"","sources":["../../src/workflows/create-app.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAQhE,UAAU,gBAAgB;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC;CACf;AAQD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,eAAe,CAAC;CACzB;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAiD3F"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vc-shell/create-vc-app",
   "description": "Application scaffolding",
-  "version": "1.1.99-alpha.2",
+  "version": "1.1.99-alpha.5",
   "type": "module",
   "bin": "./dist/index.js",
   "files": [
@@ -16,7 +16,7 @@
     "@types/lodash-es": "^4.17.12",
     "@types/pluralize": "^0.0.33",
     "@types/prompts": "^2.4.4",
-    "@vc-shell/ts-config": "1.1.99-alpha.2",
+    "@vc-shell/ts-config": "1.1.99-alpha.5",
     "copyfiles": "^2.4.1",
     "cross-env": "^7.0.3",
     "shx": "^0.3.4",
@@ -37,5 +37,5 @@
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
-  "gitHead": "600130c2990298afce79325b440f745160a1e4bf"
+  "gitHead": "d335030cb548c18c67b8d4f7a2cb0b56024ed58f"
 }

package/dist/templates/base/ai-guides/.cursorrules-vc-shell

@@ -1,529 +0,0 @@
-# VC-Shell Framework AI Guidance
-
-You are an expert in the VC-Shell framework. This file contains complete framework knowledge to help you build applications efficiently.
-
-## Framework Overview
-
-VC-Shell is a Vue 3 + TypeScript framework for building enterprise applications with:
-- Blade-based navigation system
-- Modular architecture
-- Built-in UI components
-- API client generation
-- Form validation with VeeValidate
-- Internationalization support
-
-## Blade System
-
-### Core Concepts
-- Blades are horizontal modal-like containers that stack
-- Two main types: List blades (with tables) and Details blades (with forms)
-- Navigation handled via useBladeNavigation composable
-
-### Required Blade Props (4 total)
-```typescript
-interface BladeProps {
-  expanded?: boolean;    // Expansion state
-  closable?: boolean;   // Can be closed
-  param?: string;       // Entity ID
-  options?: unknown;    // Additional data
-}
-```
-
-### Blade Events
-- `parent:call` - Communication with parent blade
-- `close:blade` - Close current blade
-- `collapse:blade` - Collapse blade
-- `expand:blade` - Expand blade
-
-### Blade Toolbar
-```typescript
-interface IBladeToolbar {
-  id: string;
-  title: string;
-  icon?: string;
-  onClick: () => void;
-  disabled?: boolean;
-  loading?: boolean;
-}
-```
-
-## Module Structure
-
-Standard module layout:
-```
-src/modules/[name]/
-├── pages/
-│   ├── list.vue          // List blade with VcTable
-│   ├── details.vue       // Details blade with VcForm
-│   └── index.ts          // Export pages
-├── composables/
-│   ├── use[Name]List/
-│   │   └── index.ts      // List logic with useAsync
-│   ├── use[Name]Details/
-│   │   └── index.ts      // Details logic with useModificationTracker
-│   └── index.ts          // Export composables
-├── locales/
-│   ├── en.json           // Translations
-│   └── index.ts          // Export locales
-├── components/           // Optional module-specific components
-└── index.ts              // Module registration with createAppModule
-```
-
-## Core Composables
-
-### useAsync
-Handles async operations with loading states and error handling:
-```typescript
-const { action, loading, error } = useAsync(async () => {
-  return await apiCall();
-});
-```
-
-### useBladeNavigation
-Manages blade navigation:
-```typescript
-const { openBlade, closeBlade } = useBladeNavigation();
-
-// Open blade
-openBlade({
-  blade: DetailsComponent,
-  param: id,
-  options: { data }
-});
-
-// Close current blade
-closeBlade();
-```
-
-### useModificationTracker
-Tracks form changes for dirty state:
-```typescript
-const item = ref({ /* form data */ });
-const { isModified, currentValue, pristineValue, resetModificationState } = useModificationTracker(item);
-
-// Use currentValue for data operations
-currentValue.value = await loadItem(id);
-await saveItem(currentValue.value);
-resetModificationState(); // After successful save
-```
-
-### useApiClient
-Provides API client with authentication:
-```typescript
-const { getApiClient } = useApiClient(GeneratedClient);
-const client = getApiClient();
-```
-
-### useMenuService
-Registers menu items:
-```typescript
-useMenuService().addMenuItem({
-  id: 'my-module',
-  title: 'My Module',
-  url: '/my-module',
-  icon: 'my-icon',
-  priority: 100
-});
-```
-
-### usePermissions
-Handles access control:
-```typescript
-const { checkPermission } = usePermissions();
-const canEdit = checkPermission('my-module:edit');
-```
-
-## API Integration
-
-### Setup Process
-1. Scaffolded apps already have `generate-api-client` script
-2. Add to `.env.local`: `APP_PLATFORM_URL=https://platform-url/`
-3. Run: `yarn generate-api-client`
-4. Use: `const { getApiClient } = useApiClient(Client)`
-
-### Module Integration
-```typescript
-// In src/main.ts
-import MyModule from './modules/my-module';
-app.use(MyModule, { router });
-```
-
-## Form Validation Pattern
-
-Correct VeeValidate integration:
-```vue
-<Field name="fieldName" v-slot="{ errors, errorMessage, handleChange }" :rules="{ required: true }">
-  <VcInput 
-    :model-value="data.fieldName" 
-    :error-message="errorMessage"
-    :error="!!errors.length"
-    @update:model-value="(v) => { data.fieldName = v; handleChange(v); }"
-  />
-</Field>
-```
-
-## UI Components Reference
-
-### ATOMS (20 components)
-
-**VcBadge** - Notification badge
-- Props: content, active, disabled, clickable, size (s|m), isDot, variant (primary|success|warning|danger|info|secondary), customPosition, top, right
-- Emits: click
-- Slots: default
-
-**VcButton** - Action button
-- Props: icon, iconClass, iconSize, variant (primary|secondary), disabled, size (xs|sm|base), selected, text
-- Emits: click
-- Slots: default
-
-**VcCard** - Container card
-- Props: header, icon, isCollapsable, isCollapsed, fill, variant (default|success|danger)
-- Emits: header:click, state:collapsed
-- Slots: default, actions, header
-
-**VcCol** - Column layout
-- Props: size (number)
-- Slots: default
-
-**VcContainer** - Scrollable container
-- Props: shadow, noPadding, usePtr
-- Emits: scroll:ptr, scroll
-- Methods: scrollTop()
-
-**VcHint** - Helper text
-- Slots: default
-
-**VcIcon** - Universal icon
-- Props: icon, size (xs|s|m|l|xl|xxl|xxxl), variant (warning|danger|success), customSize, useContainer
-- Supports: material-, bi-, lucide-, fas fa-, svg:
-
-**VcImage** - Image display
-- Props: src, alt, size, aspectRatio, bordered, rounded
-
-**VcLabel** - Text label
-- Props: text, required
-- Slots: default
-
-**VcLink** - Hyperlink
-- Props: to, href, target
-- Slots: default
-
-**VcLoading** - Loading indicator
-- Props: active
-
-**VcProgress** - Progress bar
-- Props: value (0-100), variant
-
-**VcRow** - Row layout
-- Slots: default
-
-**VcSkeleton** - Loading skeleton
-- Props: variant (text|circle|rect), width, height, count
-
-**VcStatus** - Status indicator
-- Props: variant, outline, extend
-- Slots: default
-
-**VcStatusIcon** - Status icon
-- Props: variant
-
-**VcTooltip** - Tooltip
-- Props: text, placement, width, maxWidth
-- Slots: default
-
-**VcVideo** - Video player
-- Props: src, poster, controls, autoplay, loop, muted
-
-**VcWidget** - Dashboard widget
-- Props: title, icon, value, loading
-- Emits: click
-
-**VcBanner** - Banner message
-- Props: variant, icon, iconSize, iconVariant
-- Slots: title, default, trigger
-
-### MOLECULES (18 components)
-
-**VcBreadcrumbs** - Navigation breadcrumbs
-- Props: items (array of {id, title, icon?})
-- Emits: item:click
-
-**VcCheckbox** - Checkbox input
-- Props: modelValue, label, disabled, errorMessage, hint
-- Emits: update:modelValue
-
-**VcEditor** - Rich text editor (TipTap)
-- Props: modelValue, placeholder, editable, customToolbar
-- Emits: update:modelValue
-
-**VcField** - Form field wrapper
-- Props: label, required, errorMessage, hint, tooltip
-- Slots: default
-
-**VcFileUpload** - File upload
-- Props: accept, multiple, disabled, maxSize, errorMessage
-- Emits: upload
-
-**VcForm** - Form container (VeeValidate)
-- Emits: submit
-- Slots: default
-
-**VcInput** - Text input
-- Props: modelValue, label, placeholder, type, disabled, required, clearable, errorMessage, tooltip, maxlength, prefix, suffix
-- Emits: update:modelValue, blur, focus, clear
-
-**VcInputCurrency** - Currency input
-- Props: modelValue, label, currency, locale, disabled, required, errorMessage
-- Emits: update:modelValue
-
-**VcInputDropdown** - Input with dropdown
-- Props: modelValue, option, options, label, placeholder, disabled
-- Emits: update:modelValue, update:option
-
-**VcMultivalue** - Multi-value input
-- Props: modelValue, placeholder, disabled, dictionary
-- Emits: update:modelValue
-
-**VcPagination** - Pagination
-- Props: pages, currentPage, maxVisiblePages
-- Emits: itemClick
-
-**VcRadioButton** - Radio button
-- Props: modelValue, value, label, name, disabled
-- Emits: update:modelValue
-
-**VcRating** - Star rating
-- Props: modelValue, max, readonly, size
-- Emits: update:modelValue
-
-**VcSelect** - Dropdown select (async search)
-- Props: modelValue, options, label, placeholder, multiple, searchable, clearable, disabled, loading, errorMessage, optionValue, optionLabel, searchMethod, tooltip
-- Emits: update:modelValue, search, open, close
-
-**VcSlider** - Range slider
-- Props: modelValue, min, max, step, disabled
-- Emits: update:modelValue
-
-**VcSwitch** - Toggle switch
-- Props: modelValue, label, disabled
-- Emits: update:modelValue
-
-**VcTextarea** - Multi-line text
-- Props: modelValue, label, placeholder, rows, maxlength, disabled, required, errorMessage
-- Emits: update:modelValue
-
-**VcToast** - Toast notification
-- Props: variant, text, timeout, closable
-- Use via: notification() API
-
-### ORGANISMS (7 components)
-
-**VcApp** - Application shell
-- Props: disableMenu, disableAppSwitcher, version, avatar, name, role, appsList, isEmbedded
-- Emits: menuItemClick, switchApp
-- Slots: navmenu, userDropdown, appSwitcher, toolbar, default
-
-**VcBlade** - Blade container
-- Props: title, toolbarItems (IBladeToolbar[]), expanded, closable, width, modified
-- Emits: parent:call, close:blade, collapse:blade, expand:blade
-- Slots: default, toolbar, actions
-
-**VcDynamicProperty** - Dynamic properties
-- Props: properties, modelValue, disabled
-- Emits: update:modelValue
-
-**VcGallery** - Image gallery
-- Props: images, activeIndex
-- Emits: update:activeIndex, close
-
-**VcLoginForm** - Login form
-- Props: logo, title
-- Emits: submit
-
-**VcPopup** - Modal popup
-- Props: modelValue, title, variant, width, maxWidth, closable
-- Emits: update:modelValue, close
-- Slots: default, actions, title
-
-**VcTable** - Data table
-- Props: items, columns (ITableColumns[]), loading, selectedItemId, totalCount, pages, currentPage, enableItemActions, itemActionBuilder, multiselect, stateKey
-- Emits: itemClick, selectionChanged, headerClick, pageChanged, reorder
-- Slots: header, filters, mobile-item, item_[field], header_[field], notfound, empty, footer
-- Columns: { id, title, field, type, sortable, width, alwaysVisible }
-
-## Common Patterns
-
-### List Blade Pattern
-```vue
-<template>
-  <VcBlade :expanded="true" :closable="true" :param="undefined" :options="undefined">
-    <VcTable 
-      :items="items" 
-      :columns="columns" 
-      :loading="loading"
-      @item-click="handleItemClick"
-    />
-  </VcBlade>
-</template>
-```
-
-### Details Blade Pattern
-```vue
-<template>
-  <VcBlade :expanded="true" :closable="true" :param="id" :options="undefined">
-    <VcForm @submit="handleSubmit">
-      <Field name="name" v-slot="{ errors, errorMessage, handleChange }" :rules="{ required: true }">
-        <VcInput 
-          :model-value="data.name" 
-          :error-message="errorMessage"
-          @update:model-value="(v) => { data.name = v; handleChange(v); }"
-        />
-      </Field>
-    </VcForm>
-  </VcBlade>
-</template>
-```
-
-## CLI Commands Reference
-
-### Application Creation
-```bash
-# Interactive mode
-npx create-vc-app my-app
-
-# Non-interactive mode
-npx create-vc-app my-app --package-name "my-app" --base-path "/apps/my-app/" --skip-module-gen
-```
-
-### Module Generation
-```bash
-# Interactive mode
-npx create-vc-app blade
-
-# Generate module with grid blade
-npx create-vc-app blade --module products --type grid --name products --is-workspace
-
-# Generate details blade with form fields
-npx create-vc-app blade --module products --type details --name product-details --form-fields '[...]'
-
-# Generate widget
-npx create-vc-app blade --widget
-```
-
-### Development Commands
-- `yarn serve` - Start development server
-- `yarn build` - Build for production
-- `yarn generate-api-client` - Generate API client from OpenAPI
-- `yarn lint` - Run ESLint
-- `yarn type-check` - Run TypeScript checks
-- `yarn test` - Run tests
-
-## Common Development Patterns
-
-### Pattern 1: Generate Module with CLI
-```typescript
-// When user says: "Create a products module"
-// Use CLI in non-interactive mode:
-npx create-vc-app blade --module products --type grid --name products --is-workspace
-npx create-vc-app blade --module products --type details --name product-details
-```
-
-### Pattern 2: Connect to Custom API
-```typescript
-// Create API client
-// src/api_client/custom-api.ts
-const API_URL = import.meta.env.VITE_API_URL;
-
-export const api = {
-  async getProducts(params) {
-    const response = await fetch(`${API_URL}/products`, {
-      headers: { 'Authorization': `Bearer ${token}` }
-    });
-    return response.json();
-  }
-};
-
-// Use in composable
-import { api } from '../../../api_client/custom-api';
-const { data } = await api.getProducts({ page, limit });
-```
-
-### Pattern 3: Dynamic Form Fields
-```typescript
-// Control field visibility with computed
-const showAdvancedFields = computed(() => item.value.type === 'advanced');
-
-// In template
-<template v-if="showAdvancedFields">
-  <Field name="advancedOption">...</Field>
-</template>
-```
-
-### Pattern 4: Master-Detail Relationship
-```typescript
-// Order items array
-const items = ref<OrderItem[]>([]);
-
-// Calculated total
-const total = computed(() => 
-  items.value.reduce((sum, item) => sum + item.quantity * item.price, 0)
-);
-
-// Add/remove items
-const addItem = (product) => items.value.push({ ...product, quantity: 1 });
-const removeItem = (index) => items.value.splice(index, 1);
-```
-
-### Pattern 5: File Upload
-```typescript
-const handleUpload = async (files: FileList) => {
-  for (const file of Array.from(files)) {
-    const formData = new FormData();
-    formData.append('file', file);
-    
-    await api.upload(formData, {
-      onUploadProgress: (event) => {
-        progress.value = (event.loaded / event.total) * 100;
-      }
-    });
-  }
-};
-```
-
-## Best Practices
-
-1. **Use CLI for generation:** Always use `create-vc-app` CLI to generate modules
-2. **4 Required Blade Props:** Always include expanded, closable, param, options
-3. **VeeValidate for Forms:** Use Field component for validation
-4. **useAsync for API:** Wrap API calls for loading states
-5. **Modification Tracking:** Use useModificationTracker for dirty state
-6. **Module Structure:** Follow standard module layout
-7. **TypeScript:** Use proper interfaces and types
-8. **Error Handling:** Try-catch with user-friendly messages
-9. **Localization:** Use i18n for all text
-10. **Naming:** Vc prefix for components, use prefix for composables
-
-## Error Handling
-
-```typescript
-const { action: loadData, error } = useAsync(async () => {
-  try {
-    const response = await api.getData();
-    return response.data;
-  } catch (err) {
-    notification.error('Failed to load data', { timeout: 5000 });
-    console.error('API Error:', err);
-    throw err;
-  }
-});
-```
-
-## Performance Tips
-
-- Use `computed` for derived values
-- Implement loading states with `useAsync`
-- Lazy load routes: `component: () => import('./page.vue')`
-- Use proper TypeScript types
-- Debounce search inputs
-- Paginate large datasets
-