@adlas/create-app 1.0.0

package/templates/configs/eslint.config.mjs

@@ -0,0 +1,119 @@
+import { dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import antfu from '@antfu/eslint-config';
+import jsxA11y from 'eslint-plugin-jsx-a11y';
+import tailwind from 'eslint-plugin-tailwindcss';
+
+export default antfu(
+  {
+    react: true,
+    nextjs: true,
+    typescript: true,
+
+    // Configuration preferences
+    lessOpinionated: true,
+    isInEditor: false,
+
+    // Code style
+    stylistic: {
+      semi: true,
+    },
+
+    // Format settings
+    formatters: {
+      css: true,
+      prettier: {
+        printWidth: 130,
+        singleQuote: true,
+        semi: true,
+        trailingComma: 'all',
+      },
+    },
+
+    // Ignored paths
+    ignores: ['migrations/**/*', '**/*.md', '**/*.yml', '**/*.yaml'],
+  },
+  // --- Accessibility Rules ---
+  jsxA11y.flatConfigs.recommended,
+  // --- Tailwind CSS Rules ---
+  ...tailwind.configs['flat/recommended'],
+  {
+    settings: {
+      tailwindcss: {
+        config: `${dirname(fileURLToPath(import.meta.url))}/src/styles/globals.css`,
+      },
+    },
+  },
+  // --- Custom Rule Overrides ---
+  {
+    rules: {
+      'antfu/no-top-level-await': 'off', // Allow top-level await
+      'antfu/consistent-chaining': 'off', // Allow line breaks in method chains for readability
+      'style/brace-style': 'off', // Let Prettier handle brace style
+      'style/indent': 'off', // Let Prettier handle indentation
+      'style/jsx-curly-newline': 'off', // Let Prettier handle JSX curly brace newlines
+      'ts/consistent-type-definitions': ['error', 'type'], // Use `type` instead of `interface`
+      'react/prefer-destructuring-assignment': 'off', // Vscode doesn't support automatically destructuring, it's a pain to add a new variable
+      'node/prefer-global/process': 'off', // Allow using `process.env`
+      'test/padding-around-all': 'error', // Add padding in test files
+      'test/prefer-lowercase-title': 'off', // Allow using uppercase titles in test titles
+      'react-hooks-extra/no-direct-set-state-in-use-effect': 'off', // Allow direct setState in useEffect
+      // Maximum line length
+      'style/max-len': [
+        'error',
+        {
+          code: 130, // Maximum characters per line
+          tabWidth: 2,
+          ignoreUrls: true,
+          ignoreStrings: true,
+          ignoreTemplateLiterals: true,
+          ignoreRegExpLiterals: true,
+          ignoreComments: true, // Ignore comment length
+        },
+      ],
+
+      // Disable conflicting rules with Prettier
+      'style/quotes': 'off', // Let Prettier handle quote style
+      'style/quote-props': 'off', // Let Prettier handle property quoting
+      'style/multiline-ternary': 'off', // Let Prettier handle ternary formatting
+      'style/operator-linebreak': 'off', // Let Prettier handle operator linebreaks
+      'style/arrow-parens': 'off', // Let Prettier handle arrow function parens
+      'style/indent-binary-ops': 'off', // Let Prettier handle binary operator indentation
+      'style/jsx-one-expression-per-line': 'off', // Let Prettier handle JSX line breaks
+      'style/jsx-wrap-multilines': 'off', // Let Prettier handle JSX wrapping
+      'tailwindcss/classnames-order': 'error', // ESLint plugin handles Tailwind class ordering
+
+      // Import ordering and grouping
+      'perfectionist/sort-imports': [
+        'error',
+        {
+          type: 'natural',
+          order: 'asc',
+          groups: [
+            'side-effect-style',
+            'style',
+            'type',
+            'react',
+            'builtin',
+            'external',
+            'internal-type',
+            'internal',
+            ['parent-type', 'sibling-type', 'index-type'],
+            ['parent', 'sibling', 'index'],
+            'side-effect',
+            'object',
+            'unknown',
+          ],
+          customGroups: {
+            value: {
+              react: ['^react$', '^react-dom$'],
+            },
+          },
+          newlinesBetween: 'always',
+          internalPattern: ['^@/'],
+        },
+      ],
+    },
+  },
+);

package/templates/configs/knip.config.ts

@@ -0,0 +1,32 @@
+import type { KnipConfig } from 'knip';
+
+const config: KnipConfig = {
+  // Files to exclude from Knip analysis
+  ignore: [
+    'src/libs/I18n.ts',
+    'src/types/I18n.ts',
+    'src/types/i18n.ts',
+    'src/utils/Helpers.ts',
+    'src/styles/hero.ts',
+    'src/components/icons/**',
+    'src/components/ui/**',
+    'lint-staged.config.js',
+    'src/libs/I18nNavigation.ts',
+    'svgr.config.mjs',
+    '.prettierrc.icons.cjs',
+  ],
+  // Dependencies to ignore during analysis
+  ignoreDependencies: [
+    '@react-types/shared',
+    'conventional-changelog-conventionalcommits',
+    '@svgr/babel-plugin-remove-jsx-attribute',
+    'autoprefixer',
+    'dotenv-cli',
+    'tailwind-variants',
+  ],
+  compilers: {
+    css: (text: string) => [...text.matchAll(/(?<=@)import[^;]+/g)].join('\n'),
+  },
+};
+
+export default config;

package/templates/configs/lefthook.yml

@@ -0,0 +1,42 @@
+# Validate commit messages
+commit-msg:
+  commands:
+    commitlint:
+      run: npx --no -- commitlint --edit {1}
+
+# Validate content before committing
+pre-commit:
+  commands:
+    # Format code with prettier
+    prettier:
+      glob: '*.{js,jsx,ts,tsx,json,css,scss,md,mdx,yml,yaml}'
+      run: pnpm prettier:format {staged_files}
+      stage_fixed: true
+      priority: 1
+    # Fix double spaces in className
+    lint-spaces:
+      glob: '*.{tsx,jsx}'
+      run: pnpm lint:spaces
+      stage_fixed: true
+      priority: 2
+    # Lint and fix code
+    lint:
+      glob: '*.{js,jsx,ts,tsx}'
+      run: eslint --fix {staged_files}
+      stage_fixed: true
+      priority: 3
+    # Type checking
+    check-types:
+      glob: '*.{ts,tsx}'
+      run: pnpm check:types
+      priority: 4
+    # Check dependencies
+    check-deps:
+      glob: '*'
+      run: pnpm check:deps
+      priority: 5
+    # Check i18n
+    check-i18n:
+      glob: '*.{ts,tsx,js,jsx}'
+      run: pnpm check:i18n
+      priority: 6

package/templates/configs/lint-staged.config.js

@@ -0,0 +1,8 @@
+module.exports = {
+  // Format code with prettier
+  '*.{js,jsx,ts,tsx,json,css,scss,md,mdx,yml,yaml}': ['prettier --write'],
+  // Lint and fix code (includes lint:spaces)
+  '*.{js,jsx,ts,tsx}': ['pnpm lint:fix'],
+  // Type checking
+  '**/*.ts?(x)': () => 'pnpm check:types',
+};

package/templates/configs/next.config.template.ts

@@ -0,0 +1,77 @@
+import type { NextConfig } from 'next';
+{{#i18n}}
+import createNextIntlPlugin from 'next-intl/plugin';
+{{/i18n}}
+{{#pwa}}
+import withPWA from 'next-pwa';
+{{/pwa}}
+
+// Define the base Next.js configuration
+const baseConfig: NextConfig = {
+  reactStrictMode: true,
+  poweredByHeader: false,
+  typescript: {
+    ignoreBuildErrors: false,
+  },
+  eslint: {
+    ignoreDuringBuilds: false,
+  },
+  images: {
+    // Optimized quality: 75 provides excellent visual quality at ~50% smaller file size
+    // Next.js automatically generates WebP/AVIF when browser supports it
+    qualities: [75, 85, 100],
+    formats: ['image/avif', 'image/webp'],
+    deviceSizes: [640, 750, 828, 1080, 1200, 1920, 2048, 3840],
+    imageSizes: [16, 32, 48, 64, 96, 128, 256, 384, 512, 1024],
+    // Cache images for 7 days (604800 seconds) for better performance
+    minimumCacheTTL: 604800,
+    remotePatterns: [
+      {
+        protocol: 'https',
+        hostname: '**',
+        pathname: '/**',
+      },
+    ],
+  },
+  experimental: {
+    serverActions: {
+      bodySizeLimit: '10mb',
+    },
+  },
+  {{#ssr}}
+  output: 'standalone',
+  {{/ssr}}
+  {{^ssr}}
+  output: 'export',
+  {{/ssr}}
+  webpack(config) {
+    // SVGR configuration for importing SVGs as React components
+    config.module.rules.push({
+      test: /\.svg$/i,
+      issuer: /\.[jt]sx?$/,
+      use: ['@svgr/webpack'],
+    });
+
+    return config;
+  },
+};
+
+{{#pwa}}
+// Configure PWA
+const pwaConfig = withPWA({
+  dest: 'public',
+  register: true,
+  skipWaiting: true,
+  disable: process.env.NODE_ENV === 'development',
+})(baseConfig);
+{{/pwa}}
+
+{{#i18n}}
+// Initialize the Next-Intl plugin
+const configWithPlugins = createNextIntlPlugin('./src/libs/I18n.ts')({{#pwa}}pwaConfig{{/pwa}}{{^pwa}}baseConfig{{/pwa}});
+{{/i18n}}
+{{^i18n}}
+const configWithPlugins = {{#pwa}}pwaConfig{{/pwa}}{{^pwa}}baseConfig{{/pwa}};
+{{/i18n}}
+
+export default configWithPlugins;

package/templates/configs/next.config.ts

@@ -0,0 +1,43 @@
+import type { NextConfig } from 'next';
+
+import createNextIntlPlugin from 'next-intl/plugin';
+
+// Define the base Next.js configuration
+const baseConfig: NextConfig = {
+  reactStrictMode: true,
+  poweredByHeader: false,
+  typescript: {
+    ignoreBuildErrors: false,
+  },
+  eslint: {
+    ignoreDuringBuilds: false,
+  },
+  images: {
+    // Optimized quality: 75 provides excellent visual quality at ~50% smaller file size
+    // Next.js automatically generates WebP/AVIF when browser supports it
+    qualities: [75, 85, 100],
+    formats: ['image/avif', 'image/webp'],
+    deviceSizes: [640, 750, 828, 1080, 1200, 1920, 2048, 3840],
+    imageSizes: [16, 32, 48, 64, 96, 128, 256, 384, 512, 1024],
+    // Cache images for 7 days (604800 seconds) for better performance
+    minimumCacheTTL: 604800,
+    remotePatterns: [
+      {
+        protocol: 'https',
+        hostname: 'berndorf-dashboard.adlas.cloud',
+        pathname: '/**',
+      },
+    ],
+  },
+  experimental: {
+    serverActions: {
+      bodySizeLimit: '10mb',
+    },
+  },
+  output: 'standalone',
+};
+
+// Initialize the Next-Intl plugin
+const configWithPlugins = createNextIntlPlugin('./src/libs/I18n.ts')(baseConfig);
+
+export default configWithPlugins;

package/templates/configs/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "adlas-app",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev --turbopack",
+    "build": "next build",
+    "start": "next start",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "knip": "knip",
+    "prepare": "lefthook install",
+    "commit": "commit",
+    "check:i18n": "lingual-check --patterns 'src/**/*.{ts,tsx}' --locales 'locales/*.json' --unused --missing"
+  },
+  "dependencies": {
+    "@heroui/react": "^2.7.8",
+    "@internationalized/date": "^3.8.0",
+    "@tanstack/react-query": "^5.66.0",
+    "axios": "^1.7.9",
+    "clsx": "^2.1.1",
+    "framer-motion": "^12.4.7",
+    "next": "^15.3.0",
+    "next-intl": "^4.1.0",
+    "next-themes": "^0.4.4",
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
+    "sonner": "^2.0.3",
+    "tailwind-variants": "^1.0.0",
+    "usehooks-ts": "^3.1.1",
+    "zod": "^3.24.2",
+    "zustand": "^5.0.3"
+  },
+  "devDependencies": {
+    "@antfu/eslint-config": "^4.11.0",
+    "@commitlint/cli": "^19.8.0",
+    "@commitlint/config-conventional": "^19.8.0",
+    "@commitlint/prompt-cli": "^19.8.0",
+    "@commitlint/types": "^19.8.0",
+    "@eslint-react/eslint-plugin": "^1.42.1",
+    "@lingual/i18n-check": "^1.0.3",
+    "@next/eslint-plugin-next": "^15.3.0",
+    "@react-types/shared": "^3.27.0",
+    "@svgr/babel-plugin-remove-jsx-attribute": "^8.0.0",
+    "@svgr/cli": "^8.1.0",
+    "@tailwindcss/postcss": "^4.1.0",
+    "@tanstack/react-query-devtools": "^5.66.0",
+    "@total-typescript/ts-reset": "^0.6.1",
+    "@types/node": "^22.13.4",
+    "@types/react": "^19.0.10",
+    "@types/react-dom": "^19.0.4",
+    "autoprefixer": "^10.4.21",
+    "conventional-changelog-conventionalcommits": "^9.0.0",
+    "dotenv-cli": "^8.0.0",
+    "eslint": "^9.21.0",
+    "eslint-plugin-format": "^1.0.1",
+    "eslint-plugin-jsx-a11y": "^6.10.2",
+    "eslint-plugin-react-hooks": "^5.1.0",
+    "eslint-plugin-react-refresh": "^0.4.19",
+    "eslint-plugin-tailwindcss": "^3.18.0",
+    "immer": "^10.1.1",
+    "knip": "^5.46.0",
+    "lefthook": "^1.11.6",
+    "postcss": "^8.5.3",
+    "postcss-load-config": "^6.0.1",
+    "prettier": "^3.5.2",
+    "prettier-plugin-tailwindcss": "^0.6.11",
+    "rimraf": "^6.0.1",
+    "tailwindcss": "^4.1.0",
+    "typescript": "^5.8.2"
+  },
+  "packageManager": "pnpm@10.6.1"
+}

package/templates/configs/postcss.config.mjs

@@ -0,0 +1,15 @@
+/**
+ * PostCSS Configuration
+ * @type {import('postcss-load-config').Config}
+ *
+ * This file configures the PostCSS processor which transforms CSS with JavaScript plugins.
+ * It's used in the build process to process CSS files before they're served to the browser.
+ */
+const config = {
+  plugins: {
+    // Add Tailwind CSS support
+    '@tailwindcss/postcss': {},
+  },
+};
+
+export default config;

package/templates/configs/svgr.config.mjs

@@ -0,0 +1,129 @@
+export default {
+  icon: true,
+  exportAsDefault: true,
+  typescript: true,
+  native: false,
+  prettier: false,
+  jsxRuntime: 'automatic',
+  indexTemplate: filePaths => {
+    const exportEntries = filePaths.map(filePath => {
+      // Handle case where filePath might be an object instead of a string
+      const path = typeof filePath === 'string' ? filePath : filePath.path || '';
+
+      // Extract the basename (filename without extension)
+      const parts = path.toString().split('/');
+      const filename = parts[parts.length - 1] || '';
+      const basename = filename.split('.')[0] || '';
+
+      // Check if the file is already named with "Icon" suffix (case insensitive)
+      const hasIconSuffix = /icon$/i.test(basename);
+
+      // For files already named with Icon (e.g., HeartIcon.svg), get just the base name (e.g., Heart)
+      const baseName = hasIconSuffix ? basename.replace(/icon$/i, '') : basename;
+
+      // Create the proper component name with Icon suffix
+      const componentName = `${baseName}Icon`;
+
+      return `export { default as ${componentName} } from './${basename}';`;
+    });
+
+    return exportEntries.join('\n');
+  },
+  // Set stroke to foreground color for render hero ui render correctly
+  svgProps: {
+    fill: 'none',
+    stroke: 'foreground',
+    width: '1em',
+    height: '1em',
+  },
+  svgoConfig: {
+    plugins: [
+      {
+        name: 'preset-default',
+        params: {
+          overrides: {
+            // Disable merging of paths
+            mergePaths: false,
+            // Keep individual path elements
+            convertShapeToPath: false,
+            // Preserve stroke attributes
+            removeUnknownsAndDefaults: {
+              keepAriaAttrs: true,
+              keepDataAttrs: true,
+              unknownAttrs: false,
+            },
+            // Don't remove viewBox
+            removeViewBox: false,
+          },
+        },
+      },
+      // Disable prefixIds plugin separately
+      {
+        name: 'prefixIds',
+        active: false,
+      },
+    ],
+  },
+  jsx: {
+    runtime: 'automatic',
+    babelConfig: {
+      plugins: [
+        [
+          '@svgr/babel-plugin-remove-jsx-attribute',
+          {
+            elements: [
+              'svg',
+              'path',
+              'circle',
+              'line',
+              'ellipse',
+              'polyline',
+              'polygon',
+              'g',
+              'defs',
+              'clipPath',
+              'rect',
+            ],
+            attributes: ['fill', 'stroke', 'stroke-width', 'strokeWidth', 'xmlns', 'xmlnsXlink'],
+          },
+        ],
+      ],
+    },
+  },
+  filenameCase: 'pascal',
+  prefix: false,
+  template: (variables, { tpl }) => {
+    // Extract the filename from componentName (remove Svg prefix)
+    const nameWithoutPrefix = variables.componentName.replace(/^Svg/, '');
+
+    // Normalize the name using the result after removing SVG prefix
+    const filename = nameWithoutPrefix.split('/').pop();
+    const fileBaseName = filename ? filename.split('.')[0] : nameWithoutPrefix;
+
+    // Check if the file is already named with "Icon" suffix (case insensitive)
+    const hasIconSuffix = /icon$/i.test(fileBaseName);
+
+    // For files already named with Icon (e.g., HeartIcon.svg), get just the base name (e.g., Heart)
+    // Otherwise use the original name
+    const baseName = hasIconSuffix ? fileBaseName.replace(/icon$/i, '') : fileBaseName;
+
+    // Create the proper component name with Icon suffix
+    const newComponentName = `${baseName}Icon`;
+
+    // Update the component name
+    variables.componentName = newComponentName;
+
+    // Return the template with proper formatting
+    return tpl`
+${variables.imports};
+
+${variables.interfaces};
+
+const ${variables.componentName} = (${variables.props}) => (
+  ${variables.jsx}
+);
+
+export default ${variables.componentName};
+    `;
+  },
+};

package/templates/configs/tsconfig.json

@@ -0,0 +1,75 @@
+/* eslint-disable jsonc/sort-keys */
+{
+  "compilerOptions": {
+    // ======================================================================
+    // Language & Environment
+    // Defines JavaScript version and runtime environment
+    // ======================================================================
+    "target": "ES2017",
+    "module": "esnext",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "moduleResolution": "bundler",
+    "isolatedModules": true,
+    // ======================================================================
+    // Type Safety - Foundation
+    // Core type checking settings for a robust codebase
+    // ======================================================================
+    "strict": true,
+    "alwaysStrict": true,
+    "strictNullChecks": true,
+    "noImplicitAny": true,
+    "noImplicitThis": true,
+    // ======================================================================
+    // Type Safety - Advanced
+    // Additional checks for higher code quality
+    // ======================================================================
+    "noUncheckedIndexedAccess": true,
+    "noImplicitReturns": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "allowUnreachableCode": false,
+    "useUnknownInCatchVariables": true,
+    "noImplicitOverride": true,
+    // ======================================================================
+    // Interoperability
+    // Settings for working with different file types and modules
+    // ======================================================================
+    "allowJs": true,
+    "checkJs": false,
+    "esModuleInterop": true,
+    "resolveJsonModule": true,
+    // ======================================================================
+    // Build & Performance
+    // Settings that affect compilation output and build performance
+    // ======================================================================
+    "skipLibCheck": true,
+    "removeComments": true,
+    "preserveConstEnums": true,
+    "forceConsistentCasingInFileNames": true,
+    // ======================================================================
+    // Project Structure
+    // Configure import paths and module resolution
+    // ======================================================================
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"],
+      "@/public/*": ["./public/*"]
+    },
+    // ======================================================================
+    // Next.js Project Configuration
+    // Controls settings specific to Next.js framework
+    // ======================================================================
+    "jsx": "preserve", // Preserve JSX for Next.js transformation
+    "incremental": true, // Enable faster incremental builds
+    "noEmit": true, // Skip emitting files (Next.js handles this)
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ] // Enable Next.js TypeScript plugin
+  },
+  // Files to include/exclude from the project
+  "exclude": ["node_modules"],
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts", "**/*.mts"]
+}