npm - @donotdev/cli - Versions diffs - 0.0.3 - Mend

@donotdev/cli 0.0.3

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 (281) hide show

package/templates/app-vite/index.html.example ADDED Viewed

@@ -0,0 +1,127 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <!-- ✅ CORE: Performance-critical meta tags first -->
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <meta name="color-scheme" content="light dark" />
+  <!-- ✅ DnDev: Framework will inject FaviconHead here -->
+  <!-- All favicon links will be added by FaviconHead component -->
+  <!-- ✅ DnDev: Asset manifest injection point -->
+  <!-- window.__DNDEV_ASSETS__ and __DNDEV_ASSET_MANIFEST__ injected here -->
+  <!-- ✅ PWA: Manifest link (if exists) -->
+  <link rel="manifest" href="/manifest.json" />
+  <!-- ✅ PERFORMANCE: Preconnect to external domains (OAuth providers) -->
+  <!-- GitHub OAuth -->
+  <link rel="preconnect" href="https://github.com">
+  <link rel="preconnect" href="https://api.github.com">
+  <!-- Google OAuth (remove if not using) -->
+  <link rel="preconnect" href="https://accounts.google.com">
+  <link rel="preconnect" href="https://oauth2.googleapis.com">
+  <link rel="preconnect" href="https://apis.google.com">
+  <link rel="preconnect" href="https://www.googleapis.com">
+  <!-- ✅ SEO: Basic meta tags (AutoMetaTags will override these) -->
+  <title>Loading...</title>
+  <meta name="description" content="Modern web application powered by DoNotDev" />
+  <!-- ✅ PERFORMANCE: Critical CSS inlined here by build -->
+  <style>
+    /* Critical above-the-fold styles */
+    body {
+      margin: 0;
+      font-family: var(--font-family, ui-monospace, 'SF Mono', 'Cascadia Code', 'Roboto Mono', Consolas, Monaco, 'Liberation Mono', monospace);
+      line-height: 1.5;
+      -webkit-font-smoothing: antialiased;
+      -moz-osx-font-smoothing: grayscale;
+      background: #ffffff;
+      color: #000000;
+    }
+    @media (prefers-color-scheme: dark) {
+      body {
+        background: #000000;
+        color: #ffffff;
+      }
+    }
+    /* Critical shell loader styles - pure CSS, instant render */
+    #shell-loader {
+      position: fixed;
+      top: 0;
+      left: 0;
+      width: 100%;
+      height: 100%;
+      background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      z-index: 9999;
+      opacity: 1;
+      transition: opacity 0.3s ease-out;
+    }
+    #shell-loader.shell-loader--fading {
+      opacity: 0;
+    }
+    .shell-loader__content {
+      text-align: center;
+      color: white;
+      font-family: ui-monospace, 'SF Mono', 'Cascadia Code', 'Roboto Mono', Consolas, Monaco, 'Liberation Mono', monospace !important;
+      font-size: 2.4em;
+      font-weight: 500;
+      line-height: 1.8;
+    }
+    .shell-loader__brand {
+      display: block;
+    }
+    .shell-loader__dots {
+      display: inline-flex;
+      align-items: center;
+      gap: 12px;
+    }
+    .shell-loader__dots span {
+      display: inline-block;
+      width: 12px;
+      height: 12px;
+      border-radius: 50%;
+      background: white;
+      animation: blink 1.4s infinite;
+    }
+    .shell-loader__dots span:nth-child(1) { animation-delay: 0s; }
+    .shell-loader__dots span:nth-child(2) { animation-delay: 0.2s; }
+    .shell-loader__dots span:nth-child(3) { animation-delay: 0.4s; }
+    .shell-loader__content > :last-child {
+      display: block;
+    }
+    @keyframes blink {
+      0%, 80%, 100% { opacity: 0.3; }
+      40% { opacity: 1; }
+    }
+  </style>
+</head>
+<body>
+  <!-- ✅ SHELL LOADER: Branded loading experience before React loads -->
+  <div id="shell-loader">
+    <div class="shell-loader__content">
+      <span class="shell-loader__brand">DoNotDev</span>
+      <span class="shell-loader__dots">
+        <span></span>
+        <span></span>
+        <span></span>
+      </span>
+      <span>is loading</span>
+    </div>
+  </div>
+  <!-- ✅ APP: React app container -->
+  <div id="root"></div>
+  <!-- ✅ PERFORMANCE: Module script with proper attributes -->
+  <script type="module" src="/src/main.tsx"></script>
+</body>
+</html>

package/templates/app-vite/service-account-key.json.example ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ {}
2	+

package/templates/app-vite/src/App.tsx.example ADDED Viewed

@@ -0,0 +1,39 @@
+/**
+ * @fileoverview Main application component
+ * @description Root application component with configuration-driven architecture
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+import { ViteAppProviders } from '@donotdev/ui/vite';
+import { appConfig } from './config/app';
+/**
+ * Main application component
+ *
+ * Configuration-driven architecture with smart defaults.
+ * Layout preset comes from appConfig.preset (configured in config/app.ts).
+ * Layout prop is for breadcrumbs and slot customizations only.
+ * CSS variable overrides should be done in themes.css.
+ * Override only what you need - everything else has sensible defaults.
+ *
+ * Note: HomePage.tsx in src/pages/ is automatically used for the root route "/"
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+export function App() {
+  return (
+    <ViteAppProviders
+      config={appConfig}
+      layout={{
+        breadcrumbs: 'smart', // 'smart' | 'always' | 'never' | false
+        header: {
+          // end: () => <YourHeaderActions />,
+        },
+      }}
+    />
+  );
+}

package/templates/app-vite/src/Routes.tsx.example ADDED Viewed

@@ -0,0 +1,16 @@
+import { Routes as RouterRoutes, Route } from 'react-router-dom';
+// Import your pages
+import HomePage from './pages/HomePage';
+export function Routes() {
+  return (
+    <RouterRoutes>
+      {/* Public routes */}
+      <Route path="/" element={<HomePage />} />
+      {/* Protected routes */}
+    </RouterRoutes>
+  );
+}

package/templates/app-vite/src/config/app.ts.example ADDED Viewed

@@ -0,0 +1,75 @@
+/**
+ * @fileoverview Application configuration
+ * @description Defines application metadata and feature flags
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+import type { AppConfig } from '@donotdev/core';
+/**
+ * Application name constant
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+export const APP_NAME = '{{appName}}';
+/**
+ * Application short name constant
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+export const APP_SHORT_NAME = '{{appShortName}}';
+/**
+ * Application description constant
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+export const APP_DESCRIPTION = 'Built with DoNotDev Framework';
+/**
+ * Application configuration object
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+export const appConfig: AppConfig = {
+  app: {
+    name: APP_NAME,
+    shortName: APP_SHORT_NAME,
+    description: APP_DESCRIPTION,
+    // Optional: Configure footer legal links
+    // Remove any links you don't need
+    footer: {
+      legalLinks: [
+        { path: '#cookie-settings', label: 'footer.legal.cookieSettings' },
+        { path: '/legal/privacy', label: 'footer.legal.privacyPolicy' },
+        { path: '/legal/terms', label: 'footer.legal.termsOfService' },
+        // Add more links as needed:
+        // { path: '/legal/legal-notice', label: 'footer.legal.legalNotice' },
+        // { path: '/license', label: 'License' },
+      ],
+    },
+  },
+  preset: 'landing', // 'landing' | 'admin' | 'moolti' | 'docs' | 'blog' | 'game' | 'plain'
+  features: {
+    // Optional: Enable debug tools in development
+    // debug: true,
+  },
+  // Optional: Override auth routes
+  // auth: {
+  //   authRoute: '/signin',
+  //   roleRoute: '/403',
+  //   tierRoute: '/pricing',
+  // },
+};

package/templates/app-vite/src/config/legal.ts.example ADDED Viewed

@@ -0,0 +1,170 @@
+// src/config/legal.ts
+/**
+ * @fileoverview Legal Information Configuration
+ * @description Centralized legal information for Terms, Privacy, and Legal Notice pages
+ *
+ * IMPORTANT: Configure your actual legal information here.
+ * This file is used by all legal pages (Terms of Service, Privacy Policy, Legal Notice).
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ */
+import type { LegalConfig } from '@donotdev/core';
+/**
+ * Legal Configuration
+ *
+ * Fill in your actual company and legal information below.
+ * Remove any optional fields you don't need.
+ *
+ * For detailed documentation on each field, see the JSDoc in @donotdev/types or
+ * hover over any field in your IDE for inline documentation.
+ */
+export const legalConfig: LegalConfig = {
+	/**
+	 * Company/Publisher Information
+	 */
+	company: {
+		name: 'Your Company Name', // Required - Full legal name
+		shortName: 'YCN', // Optional - Abbreviation
+		legalStatus: 'LLC', // Optional - e.g., "LLC", "SARL", "SAS", "GmbH", "Ltd"
+		registrationNumber: '123456789', // Optional but recommended - e.g., SIRET (France), Company Number (UK), EIN (USA)
+		vatNumber: 'XX123456789', // Optional - VAT/Tax ID, required for EU businesses
+		shareCapital: '10,000 USD', // Optional - Required in some jurisdictions like France
+	},
+	/**
+	 * Contact Information
+	 */
+	contact: {
+		address: '123 Main Street, City, State/Province, Postal Code, Country', // Required - Registered office address
+		email: 'legal@yourcompany.com', // Required - Legal contact email
+		phone: '+1 (555) 123-4567', // Optional but recommended
+		supportEmail: 'support@yourcompany.com', // Required - Customer support email
+		privacyEmail: 'privacy@yourcompany.com', // Required - Privacy inquiries
+		dpoEmail: 'dpo@yourcompany.com', // Required for GDPR compliance if processing significant personal data
+	},
+	/**
+	 * Publication Director
+	 *
+	 * The person legally responsible for the website's content.
+	 * Required by law in France ("Directeur de la publication").
+	 */
+	director: {
+		name: 'John Doe', // Required - Full name of the responsible person
+		role: 'CEO', // Optional - Their title/role
+	},
+	/**
+	 * Hosting Provider
+	 *
+	 * Information about where your website is hosted.
+	 * Required by law in many jurisdictions including France.
+	 */
+	hosting: {
+		provider: 'Firebase Hosting by Google', // Required - Hosting service name
+		address: 'Google LLC, 1600 Amphitheatre Parkway, Mountain View, CA 94043, USA', // Optional - Hosting provider's address
+		contact: 'https://firebase.google.com/support', // Optional - Support URL or email
+	},
+	/**
+	 * Legal Jurisdiction
+	 *
+	 * Where your business operates and how disputes are resolved.
+	 */
+	jurisdiction: {
+		country: 'United States', // Required - Operating jurisdiction
+		arbitrationOrg: 'American Arbitration Association', // Optional - For dispute resolution
+		arbitrationLocation: 'New York, NY', // Optional - Where arbitration would occur
+	},
+	/**
+	 * Website Information
+	 */
+	website: {
+		url: 'https://yourcompany.com', // Required - Your main website URL
+	},
+	/**
+	 * Optional Sections Configuration
+	 *
+	 * Enable/disable specific sections in your legal pages.
+	 * Set to true to include, false to exclude.
+	 */
+	sections: {
+		// Terms of Service sections
+		terms: {
+			children: false, // Include children-specific provisions (COPPA)
+			international: true, // Include international users provisions
+			california: false, // Include California-specific provisions (CCPA)
+			eu: true, // Include EU-specific provisions
+		},
+		// Privacy Policy sections
+		privacy: {
+			children: false, // Include children's privacy provisions (COPPA)
+			international: true, // Include international data transfer provisions
+			california: false, // Include California privacy rights (CCPA)
+			eu: true, // Include EU privacy provisions (GDPR)
+		},
+		// Legal Notice sections
+		legalNotice: {
+			intellectualProperty: true, // Include IP notice
+			personalData: true, // Include link to Privacy Policy
+			cookies: true, // Include cookies reference
+		},
+	},
+} as const;
+/**
+ * Type-safe access to legal config
+ */
+export type AppLegalConfig = typeof legalConfig;
+/**
+ * QUICK START CHECKLIST:
+ *
+ * 1. Company Information:
+ *    - [ ] Update company.name with your legal entity name
+ *    - [ ] Set company.legalStatus (SARL, LLC, GmbH, etc.)
+ *    - [ ] Add company.registrationNumber (SIRET, EIN, Company Number)
+ *    - [ ] Add company.vatNumber if you're in the EU or have VAT obligations
+ *
+ * 2. Contact Information:
+ *    - [ ] Update contact.address with your registered office
+ *    - [ ] Set contact.email for legal notices
+ *    - [ ] Set contact.supportEmail for customer support
+ *    - [ ] Set contact.privacyEmail for GDPR/privacy requests
+ *    - [ ] Set contact.dpoEmail if you have a Data Protection Officer
+ *
+ * 3. Legal Responsibility:
+ *    - [ ] Update director.name (person responsible for content)
+ *    - [ ] Set director.role (CEO, Director, etc.)
+ *
+ * 4. Hosting:
+ *    - [ ] Verify hosting.provider is correct
+ *    - [ ] Update hosting.address and hosting.contact if needed
+ *
+ * 5. Jurisdiction:
+ *    - [ ] Set jurisdiction.country where you operate
+ *    - [ ] Configure arbitration details if needed
+ *
+ * 6. Optional Sections:
+ *    - [ ] Review and enable/disable sections based on your needs
+ *    - [ ] Enable sections.*.eu if you have EU users (GDPR)
+ *    - [ ] Enable sections.*.california if you have California users (CCPA)
+ *
+ * LEGAL COMPLIANCE NOTES:
+ *
+ * - France: All fields with "Required" are mandatory for French websites
+ * - EU/GDPR: contact.dpoEmail is required if you process significant personal data
+ * - USA/California: Enable California sections if you have California users
+ * - International: Enable international sections for global audience
+ *
+ * For more information, consult your legal advisor or refer to:
+ * - https://docs.dndev.com/legal/configuration (framework docs)
+ * - Your local business registration authority
+ * - GDPR guidance: https://gdpr.eu
+ */

package/templates/app-vite/src/globals.css.example ADDED Viewed

@@ -0,0 +1,11 @@
+/* apps/{{appName}}/src/globals.css */
+@import '@donotdev/ui/dndev.css';
+@import './themes.css';
+/* Override framework's default font to use Roboto */
+:root {
+  --font-sans: 'Roboto', sans-serif;
+  --font-mono: 'Roboto Mono', monospace;
+  --font-family: var(--font-sans);
+}