npm - @donotdev/cli - Versions diffs - 0.0.13 → 0.0.15 - Mend

@donotdev/cli 0.0.13 → 0.0.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (162) hide show

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@donotdev/cli",
-  "version": "0.0.13",
+  "version": "0.0.15",
   "description": "Command-line interface for DoNotDev Framework",
   "type": "module",
   "private": false,
@@ -33,7 +33,7 @@
     "type-check": "tsc --noEmit"
   },
   "dependencies": {
-    "@clack/prompts": "^1.0.0",
+    "@clack/prompts": "^1.0.1",
     "commander": "^14.0.3",
     "fast-glob": "^3.3.3"
   },

package/templates/app-demo/src/App.tsx.example CHANGED Viewed

@@ -8,6 +8,7 @@
 import { ViteAppProviders } from '@donotdev/ui/vite';
+import './config/providers';
 import { appConfig } from './config/app';
 /**

package/templates/app-demo/src/pages/FullPage.tsx.example CHANGED Viewed

@@ -34,7 +34,7 @@ export default function FullPage() {
   areas={\`"header header header"
   "main main sidebar"
   "footer footer footer"\`}
-  templateColumns="1fr 3fr 1fr"
+  cols="1fr 3fr 1fr"
   gap="none"
 >
   {/* Children */}
@@ -45,7 +45,7 @@ export default function FullPage() {
                     areas={`"header header header"
 "main main sidebar"
 "footer footer footer"`}
-                    templateColumns="1fr 3fr 1fr"
+                    cols="1fr 3fr 1fr"
                     gap="none"
                 >
                     <GridArea as="header" name="header">

package/templates/app-demo/src/pages/components/DemoLayout.tsx.example CHANGED Viewed

@@ -140,7 +140,7 @@ export function DemoLayout({
   return (
     <Grid
       className="dndev-h-screen dndev-w-full dndev-overflow-hidden"
-      templateColumns={isLaptop ? '280px 1fr' : '1fr'}
+      cols={isLaptop ? '280px 1fr' : '1fr'}
       areas={isLaptop ? 'sidebar main' : 'main'}
       gap="none"
     >
@@ -163,7 +163,7 @@ export function DemoLayout({
         <Stack className="dndev-h-full" gap="none">
           {/* Header */}
           <Grid
-            templateColumns="1fr auto 1fr"
+            cols="1fr auto 1fr"
             align="center"
             style={{
               padding: 'var(--gap-sm) var(--gap-md)',

package/templates/app-demo/src/themes.css.example CHANGED Viewed

@@ -1,3 +1,6 @@
+/**
+ * src/themes.css — SSOT for essence and theme variables. Default = SaaS. Optional .brutalist / .luxury: set class on <html>.
+ */
 /* src/themes.css */
 /* ===========================
@@ -114,18 +117,8 @@
   --warning-foreground: #09090b;
 }
+/* Optional essences: .brutalist, .luxury — see guides/dndev/essences_reference.css. They do not apply by default. */
 /* ===========================
    CUSTOM THEMES
-   Add your brand themes below
    =========================== */
-/* Example:
-:root.brand {
-  --theme-icon: 'Zap';
-  --theme-label: 'Brand';
-  --theme-is-dark: 0;
-  --background: #your-color;
-  --foreground: #your-color;
-  ...
-}
-*/

package/templates/app-expo/.env.example ADDED Viewed

@@ -0,0 +1,64 @@
+# =============================================================================
+# DoNotDev Framework Environment Variables
+# =============================================================================
+# Copy this file to .env and update with your values
+# =============================================================================
+# DoNotDev License Key
+# =============================================================================
+# Get your license key from: https://donotdev.com/pricing
+# Removes watermark and enables all features
+EXPO_PUBLIC_DONOTDEV_LICENSE_KEY=dndev_your_key_here
+# =============================================================================
+# Authentication & OAuth Providers
+# =============================================================================
+# Comma-separated list of enabled auth providers
+# Available: github (required for framework), google, facebook, discord, twitter, microsoft, spotify, linkedin, reddit, twitch, yahoo, apple
+# Uncomment when Firebase is configured
+# EXPO_PUBLIC_AUTH_PARTNERS=github
+# Comma-separated list of enabled OAuth partners for API access
+# Available: google, github, facebook, discord, twitter, microsoft, spotify, linkedin, reddit, twitch, yahoo, apple
+# EXPO_PUBLIC_OAUTH_PARTNERS=google,spotify
+# Individual OAuth client IDs (only needed for OAuth partners)
+# EXPO_PUBLIC_GOOGLE_CLIENT_ID=your_google_client_id
+# EXPO_PUBLIC_GITHUB_CLIENT_ID=your_github_client_id
+# EXPO_PUBLIC_SPOTIFY_CLIENT_ID=your_spotify_client_id
+# =============================================================================
+# Firebase Configuration
+# =============================================================================
+# Get these values from your Firebase project settings
+# Run `dndev firebase:setup` to auto-populate, or copy from Firebase Console
+EXPO_PUBLIC_FIREBASE_API_KEY=
+EXPO_PUBLIC_FIREBASE_PROJECT_ID=
+EXPO_PUBLIC_FIREBASE_AUTH_DOMAIN=
+EXPO_PUBLIC_FIREBASE_STORAGE_BUCKET=
+EXPO_PUBLIC_FIREBASE_MESSAGING_SENDER_ID=
+EXPO_PUBLIC_FIREBASE_APP_ID=
+EXPO_PUBLIC_FIREBASE_MEASUREMENT_ID=
+EXPO_PUBLIC_FIREBASE_FUNCTIONS_REGION=
+# =============================================================================
+# Firebase Emulator (Development only)
+# =============================================================================
+# Set to true to use Firebase emulators instead of production services
+EXPO_PUBLIC_USE_FIREBASE_EMULATOR=false
+EXPO_PUBLIC_FIREBASE_EMULATOR_HOST=localhost
+EXPO_PUBLIC_FIREBASE_EMULATOR_PORT=9099
+EXPO_PUBLIC_FIREBASE_AUTH_EMULATOR_HOST=http://localhost:9099
+EXPO_PUBLIC_FIREBASE_FIRESTORE_EMULATOR_HOST=localhost:8080
+EXPO_PUBLIC_FIREBASE_FUNCTIONS_EMULATOR_PORT=5001
+# =============================================================================
+# Stripe Configuration (if using billing)
+# =============================================================================
+EXPO_PUBLIC_STRIPE_PUBLISHABLE_KEY=
+# =============================================================================
+# Sentry (optional - auto-enabled if SENTRY_DSN is set)
+# =============================================================================
+# Framework automatically initializes Sentry if this variable is set
+EXPO_PUBLIC_SENTRY_DSN=

package/templates/app-expo/.expo/README.md.example ADDED Viewed

@@ -0,0 +1,5 @@
+# .expo directory
+This directory contains Expo-specific files and caches.
+**Do not commit this directory** - it's already in `.gitignore`.

package/templates/app-expo/.gitignore.example ADDED Viewed

@@ -0,0 +1,36 @@
+# Expo
+.expo/
+dist/
+web-build/
+# Native
+*.orig.*
+*.jks
+*.p8
+*.p12
+*.key
+*.mobileprovision
+# Metro
+.metro-health-check*
+# Debug
+npm-debug.*
+yarn-debug.*
+yarn-error.*
+# macOS
+.DS_Store
+*.pem
+# Local env files
+.env*.local
+# Typescript
+*.tsbuildinfo
+# EAS
+.eas/
+# Temporary files
+*.log

package/templates/app-expo/README.md.example ADDED Viewed

@@ -0,0 +1,58 @@
+# {{appName}}
+Mobile app built with DoNotDev Framework and Expo.
+## Getting Started
+### Prerequisites
+- Node.js 20+ and Bun 1.3+
+- Expo Go app on your phone (for development)
+- Firebase project (run `dndev firebase:setup`)
+### Development
+```bash
+# Install dependencies
+bun install
+# Start development server
+bun dev
+# or
+npx expo start
+# Scan QR code with Expo Go app on your phone
+```
+### Building
+```bash
+# Install EAS CLI
+npm install -g eas-cli
+# Login
+eas login
+# Build for iOS
+eas build --platform ios
+# Build for Android
+eas build --platform android
+```
+## Project Structure
+```
+app/              # Expo Router pages (file-based routing)
+  _layout.tsx     # Root layout
+  index.tsx       # Home page (/)
+src/              # Source files (components, config, etc.)
+app.json          # Expo configuration
+eas.json          # EAS Build configuration
+```
+## Documentation
+- [Expo Router Docs](https://docs.expo.dev/router/introduction/)
+- [DoNotDev Expo Package](../../../docs/development/EXPO_QUICK_START.md)
+- [WAI-WAY Guide](../../guides/wai-way/WAI_WAY_CLI.md.example)

package/templates/app-expo/app/.gitkeep ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ # This file ensures the app directory is tracked by git
2	+ # Expo Router requires the app directory to exist

package/templates/app-expo/app/_layout.tsx.example ADDED Viewed

@@ -0,0 +1,41 @@
+/**
+ * @fileoverview Root Layout
+ * @description Root layout component for Expo Router with DoNotDev providers
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+import '../src/config/providers'; // configures CRUD/auth/storage at module load
+import { Stack } from 'expo-router';
+import { ExpoAppProviders } from '@donotdev/expo';
+import { useAuth } from '@donotdev/auth';
+/**
+ * Inner layout — rendered inside ExpoAppProviders so useAuth() has context.
+ */
+function AppStack() {
+  const { user } = useAuth();
+  return (
+    <Stack
+      screenOptions={{
+        headerShown: false,
+      }}
+    />
+  );
+}
+/**
+ * Root layout component
+ * Wraps the entire app with DoNotDev providers and Expo Router Stack.
+ * useAuth() must be called inside ExpoAppProviders, not above it.
+ */
+export default function RootLayout() {
+  return (
+    <ExpoAppProviders>
+      <AppStack />
+    </ExpoAppProviders>
+  );
+}

package/templates/app-expo/app/form.tsx.example ADDED Viewed

@@ -0,0 +1,52 @@
+/**
+ * @fileoverview CRUD Form Example
+ * @description FormRenderer example page — create / edit (use with expo-router dynamic routes)
+ * Suggested file locations: app/[entity]/new.tsx or app/[entity]/[id]/edit.tsx
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+import { useState } from 'react';
+import { Alert } from 'react-native';
+import { SafeAreaView } from 'react-native-safe-area-context';
+import { useLocalSearchParams, useRouter } from 'expo-router';
+import { EntityFormRenderer, Stack, Text } from '@donotdev/expo';
+import { useCrud } from '@donotdev/crud';
+// import { productEntity } from '../entities/Product';
+const productEntity = null as any; // replace with your entity
+/**
+ * Form page component — create or edit a single record
+ */
+export default function FormPage() {
+  const router = useRouter();
+  const { id } = useLocalSearchParams<{ id?: string }>();
+  const { add, update } = useCrud(productEntity);
+  const [submitting, setSubmitting] = useState(false);
+  const handleSubmit = async (data: unknown) => {
+    setSubmitting(true);
+    try {
+      if (id) await update(id as string, data as any);
+      else await add(data as any);
+      router.back();
+    } catch (err) {
+      Alert.alert('Error', err instanceof Error ? err.message : 'Failed to save.');
+    } finally {
+      setSubmitting(false);
+    }
+  };
+  return (
+    <SafeAreaView style={{ flex: 1 }}>
+      <Stack spacing={16} style={{ flex: 1, padding: 16 }}>
+        <Text level="h2">{id ? 'Edit' : 'Create'}</Text>
+        <EntityFormRenderer entity={productEntity} entityId={id} onSubmit={handleSubmit} />
+      </Stack>
+    </SafeAreaView>
+  );
+}

package/templates/app-expo/app/index.tsx.example ADDED Viewed

@@ -0,0 +1,89 @@
+/**
+ * @fileoverview Home Page
+ * @description Welcome page for {{appName}}
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+import { View, StyleSheet } from 'react-native';
+import { Text, Card, Stack, Button } from '@donotdev/expo';
+import { useNavigate } from '@donotdev/expo';
+import { useAuth } from '@donotdev/auth';
+/**
+ * Home page component
+ */
+export default function HomePage() {
+  const navigate = useNavigate();
+  const { user } = useAuth();
+  return (
+    <View style={styles.container}>
+      <Stack spacing={24} style={styles.content}>
+        <Text level="h1">Welcome to {{appName}}</Text>
+        <Card title="Getting Started">
+          <Text level="body">
+            Your Expo app is running! Follow these steps to get started:
+          </Text>
+          <Stack spacing={16} style={styles.steps}>
+            <View>
+              <Text level="h3">1. Backend Setup</Text>
+              <Text level="small">
+                Run: dndev setup
+              </Text>
+            </View>
+            <View>
+              <Text level="h3">2. Configure Environment</Text>
+              <Text level="small">
+                Update .env with your Firebase credentials
+              </Text>
+            </View>
+            <View>
+              <Text level="h3">3. Start Building</Text>
+              <Text level="small">
+                Use WAI-WAY to build your app features
+              </Text>
+            </View>
+          </Stack>
+        </Card>
+        {user ? (
+          <Card title="You're Signed In">
+            <Text level="body">Welcome, {user.email}!</Text>
+            <Button onPress={() => navigate('/profile')}>
+              Go to Profile
+            </Button>
+          </Card>
+        ) : (
+          <Card title="Authentication">
+            <Text level="body">Sign in to get started</Text>
+            <Button onPress={() => navigate('/signin')}>
+              Sign In
+            </Button>
+          </Card>
+        )}
+      </Stack>
+    </View>
+  );
+}
+const styles = StyleSheet.create({
+  container: {
+    flex: 1,
+    padding: 16,
+  },
+  content: {
+    maxWidth: 600,
+    width: '100%',
+    alignSelf: 'center',
+  },
+  steps: {
+    marginTop: 16,
+  },
+});

package/templates/app-expo/app/list.tsx.example ADDED Viewed

@@ -0,0 +1,32 @@
+/**
+ * @fileoverview CRUD List Example
+ * @description EntityCardList example page — copy & rename (e.g. products.tsx, customers.tsx)
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+import { SafeAreaView } from 'react-native-safe-area-context';
+import { EntityCardList, Stack, Text } from '@donotdev/expo';
+import { useAuth } from '@donotdev/auth';
+// import { productEntity } from '../entities/Product';
+const productEntity = null as any; // replace with your entity
+/**
+ * List page component — shows all records for an entity
+ */
+export default function ListPage() {
+  const { user } = useAuth();
+  return (
+    <SafeAreaView style={{ flex: 1 }}>
+      <Stack spacing={16} style={{ flex: 1, padding: 16 }}>
+        <Text level="h2">Products</Text>
+        <EntityCardList entity={productEntity} userRole={user?.role} />
+      </Stack>
+    </SafeAreaView>
+  );
+}

package/templates/app-expo/app/profile.tsx.example ADDED Viewed

@@ -0,0 +1,76 @@
+/**
+ * @fileoverview Profile Page
+ * @description User profile page for {{appName}}
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+import { View, StyleSheet } from 'react-native';
+import { Text, Card, Stack, Button } from '@donotdev/expo';
+import { useAuth } from '@donotdev/auth';
+import { useNavigate } from '@donotdev/expo';
+/**
+ * Profile page component
+ */
+export default function ProfilePage() {
+  const { user, signOut } = useAuth();
+  const navigate = useNavigate();
+  if (!user) {
+    navigate('/signin');
+    return null;
+  }
+  const handleSignOut = async () => {
+    await signOut();
+    navigate('/');
+  };
+  return (
+    <View style={styles.container}>
+      <Stack spacing={24} style={styles.content}>
+        <Text level="h1">Profile</Text>
+        <Card title="Account Information">
+          <Stack spacing={12}>
+            <View>
+              <Text level="small" style={styles.label}>Email</Text>
+              <Text level="body">{user.email}</Text>
+            </View>
+            {user.displayName && (
+              <View>
+                <Text level="small" style={styles.label}>Display Name</Text>
+                <Text level="body">{user.displayName}</Text>
+              </View>
+            )}
+          </Stack>
+        </Card>
+        <Button onPress={handleSignOut} variant="destructive">
+          Sign Out
+        </Button>
+      </Stack>
+    </View>
+  );
+}
+const styles = StyleSheet.create({
+  container: {
+    flex: 1,
+    backgroundColor: '#fff',
+    padding: 16,
+  },
+  content: {
+    maxWidth: 600,
+    width: '100%',
+    alignSelf: 'center',
+  },
+  label: {
+    opacity: 0.7,
+    marginBottom: 4,
+  },
+});

package/templates/app-expo/app/signin.tsx.example ADDED Viewed

@@ -0,0 +1,53 @@
+/**
+ * @fileoverview Sign In Page
+ * @description Authentication page for {{appName}}
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+import { View, StyleSheet } from 'react-native';
+import { Text, Card, Stack, Button } from '@donotdev/expo';
+import { MultipleAuthProviders } from '@donotdev/expo';
+import { useNavigate } from '@donotdev/expo';
+/**
+ * Sign in page component
+ */
+export default function SignInPage() {
+  const navigate = useNavigate();
+  return (
+    <View style={styles.container}>
+      <Stack spacing={24} style={styles.content}>
+        <Text level="h1">Sign In</Text>
+        <Card title="Welcome Back">
+          <MultipleAuthProviders
+            onSuccess={() => {
+              navigate('/');
+            }}
+          />
+        </Card>
+        <Button onPress={() => navigate('/')} variant="outline">
+          Back to Home
+        </Button>
+      </Stack>
+    </View>
+  );
+}
+const styles = StyleSheet.create({
+  container: {
+    flex: 1,
+    backgroundColor: '#fff',
+    padding: 16,
+  },
+  content: {
+    maxWidth: 400,
+    width: '100%',
+    alignSelf: 'center',
+  },
+});

package/templates/app-expo/app.json.example ADDED Viewed

@@ -0,0 +1,39 @@
+{
+  "expo": {
+    "name": "{{appName}}",
+    "slug": "{{appName}}",
+    "version": "1.0.0",
+    "orientation": "portrait",
+    "icon": "./assets/icon.png",
+    "userInterfaceStyle": "automatic",
+    "splash": {
+      "image": "./assets/splash.png",
+      "resizeMode": "contain",
+      "backgroundColor": "#ffffff"
+    },
+    "assetBundlePatterns": [
+      "**/*"
+    ],
+    "ios": {
+      "supportsTablet": true,
+      "bundleIdentifier": "com.{{appName}}.{{appName}}"
+    },
+    "android": {
+      "adaptiveIcon": {
+        "foregroundImage": "./assets/adaptive-icon.png",
+        "backgroundColor": "#ffffff"
+      },
+      "package": "com.{{appName}}.{{appName}}"
+    },
+    "web": {
+      "favicon": "./assets/favicon.png"
+    },
+    "scheme": "{{appName}}",
+    "plugins": [
+      "expo-router"
+    ],
+    "experiments": {
+      "typedRoutes": true
+    }
+  }
+}

package/templates/app-expo/babel.config.js.example ADDED Viewed

@@ -0,0 +1,10 @@
+module.exports = function (api) {
+  api.cache(true);
+  return {
+    presets: ['babel-preset-expo'],
+    plugins: [
+      // Required for expo-router
+      'expo-router/babel',
+    ],
+  };
+};

package/templates/app-expo/eas.json.example ADDED Viewed

@@ -0,0 +1,20 @@
+{
+  "cli": {
+    "version": ">= 5.0.0"
+  },
+  "build": {
+    "development": {
+      "developmentClient": true,
+      "distribution": "internal"
+    },
+    "preview": {
+      "distribution": "internal"
+    },
+    "production": {
+      "autoIncrement": true
+    }
+  },
+  "submit": {
+    "production": {}
+  }
+}

package/templates/app-expo/expo-env.d.ts.example ADDED Viewed

@@ -0,0 +1,4 @@
+/// <reference types="expo/types" />
+// NOTE: This file should not be edited
+// It's automatically generated by Expo CLI