fg-devkit 1.0.0

package/.cursor/rules/core-coding-standards.mdc

@@ -0,0 +1,203 @@
+---
+description: Core coding standards for Vue / fds-vue-core frontend projects
+alwaysApply: true
+---
+
+# Core Coding Standards
+
+## Keep changes focused
+
+- Make the smallest safe change that solves the request.
+- Avoid unrelated refactors in the same task.
+- Preserve existing behavior unless a behavior change is requested.
+
+## Communication efficiency
+
+- Do not waste tokens: keep responses concise, high-signal, and scoped to the request.
+- Prefer short summaries over long explanations unless deeper detail is explicitly requested.
+
+## Evidence-first implementation
+
+- Never guess or hallucinate APIs, component props, or framework behavior.
+- Verify implementation details against authoritative sources first (official docs, project code, and library types/source).
+- If documentation is missing or ambiguous, state uncertainty explicitly and choose the safest validated approach.
+
+## Match project conventions
+
+- Follow established naming, file structure, and component patterns.
+- Reuse existing utilities and query/composable patterns before adding new ones.
+- Keep TypeScript types explicit at API boundaries.
+
+## Strict TypeScript
+
+- Keep TypeScript and Vue template typing strict (`strict: true`, `strictTemplates: true`).
+- Do not introduce `any`; use `unknown` for unsafe input and narrow before use.
+- Type API boundaries explicitly (request payloads, response DTOs, mutation variables, callback contracts).
+- Prefer named reusable types (for example under `src/types`) for shared domain shapes.
+- Avoid non-null assertions unless guarded by `enabled` checks or equivalent runtime guarantees.
+
+## API boundaries
+
+- Components and views should not call low-level HTTP/API clients directly for feature data fetching.
+- Centralize HTTP and endpoint wiring in a dedicated API layer (for example `src/api/endpoints/*` or the convention used in the repo).
+- Consume server state through query/mutation hooks (for example `src/queries/*` or equivalent), not ad-hoc fetches in UI code.
+
+## State-management boundaries
+
+- Use TanStack Query (or the project’s chosen data library) for server state and caching.
+- Use Pinia/Vuex only for client/app state that is not owned by the server.
+- Do not duplicate the same state across the query cache and global stores unless the project explicitly documents that pattern.
+
+## TanStack Query server-state conventions
+
+- Use TanStack Query for server state; avoid duplicating server data in ad-hoc local state.
+- Keep API calls in the API layer and expose query/mutation hooks from a dedicated hooks folder.
+- Build query keys as stable arrays of serializable primitives; when using refs, key by `.value` in a computed key.
+- Prefer shared query key constants/factories to keep invalidation and cache updates consistent.
+- Add `enabled` guards for required IDs/paths to prevent invalid requests.
+- Use `placeholderData: keepPreviousData` for paginated/filter-driven views to avoid UI flicker.
+- Set `staleTime` intentionally per resource; keep `refetchOnWindowFocus` off unless fresh-on-focus behavior is required.
+- On mutation success, update cache intentionally (`setQueryData`) and/or invalidate the narrowest matching keys.
+- Respect shared query client retry behavior and only override retries when endpoint-specific behavior is needed.
+
+## Mutation cache behavior
+
+- Every mutation should define post-success cache behavior.
+- Use `invalidateQueries` for stale collections and `setQueryData` for direct entity updates.
+- Invalidate the narrowest query keys that match changed resources.
+
+## Vue Router conventions
+
+- Organize route definitions in modules (for example `src/router/modules/*`) composed from a single router entry (for example `src/router/index.ts`), matching the repo layout.
+- Every user-facing route should define `meta.title`; provide breadcrumb metadata for detail/flow routes when needed.
+- Use shared route guards for auth/anonymous access control instead of duplicating checks in views.
+- Prefer `props: true` and typed route params in components instead of reading raw params everywhere.
+- Prefer named-route navigation for internal flows (`{ name, params, query }`) and reserve raw path pushes for simple/static redirects.
+- Preserve existing query params intentionally when updating filters, pagination, or tab state.
+- Lazy-load route components with dynamic imports to keep initial bundles smaller.
+
+## Vue and UI expectations
+
+- Prefer clear, readable templates over compact but hard-to-follow expressions.
+- Keep components focused; extract repeated UI blocks when duplication grows.
+- Keep localization text in language files instead of hardcoded UI strings.
+
+## FDS-first component usage
+
+- Use `fds-vue-core` components as the default choice for UI building blocks.
+- Before adding custom UI, check whether an FDS component already solves the use case.
+- Prefer extending composition around FDS components over re-implementing design-system behavior.
+- Keep visual consistency by matching FDS variants, spacing patterns, and interaction styles.
+
+## Asset creation policy
+
+- Do not create icons, images, illustrations, or placeholder content unless explicitly requested.
+- Assume `fds-vue-core` provides the required visual assets and use those first.
+- If a required asset appears missing, clearly point out the gap instead of inventing a replacement.
+
+## FDS typography (fds-vue-core)
+
+- For headings, use `FdsH1`, `FdsH2`, and `FdsH3` (not raw `h1/h2/h3`).
+- `FdsH1/FdsH2/FdsH3` use the `text` prop for content and support `size` (`sm|md|lg|xl|responsive`).
+- When layout spacing needs to be neutralized, reset heading spacing with `class="m-0"` (and add explicit margins as needed).
+- Use `FdsLead` for intro/lead paragraphs, `FdsMeta` for metadata/secondary text, and `FdsLabel` for short labels.
+- `FdsLead`, `FdsMeta`, and `FdsLabel` render slot content; prefer these over custom styled spans for text semantics.
+
+## Tailwind (v4+)
+
+- Use Tailwind v4 patterns and utilities (for example `tailwindcss@4` with `@tailwindcss/vite` where applicable).
+- Prefer utility classes in templates; only add custom CSS when utilities cannot express the design.
+- Follow existing FDS token/preset styling (`fds-vue-core` tokens and preset) instead of inventing parallel design tokens.
+- Always use Tailwind/FDS design tokens for colors, spacing, typography, radius, and shadows.
+- Never invent ad-hoc color values (for example hex/rgb/hsl literals) when a tokenized utility exists.
+- Keep spacing and typography explicit in class names; avoid hidden styling in deep selectors.
+- Use `!` utility overrides sparingly and only when a component default cannot be changed safely.
+- For Tailwind v4 important modifiers, use postfix-important utility syntax (for example `grid-cols-1!`) instead of prefix syntax (for example `!grid-cols-1`).
+
+## Figma MCP implementation workflow
+
+- When using Figma MCP, implement the design as specified (layout, spacing, typography, states, and interactions).
+- Treat the Figma file as source of truth for UI behavior unless product/technical constraints are explicitly documented.
+- Primary choice for implementation is `fds-vue-core` components that best match the design intent.
+- Only create custom UI when no suitable FDS component exists; keep custom parts minimal and design-token based.
+- If any Figma detail cannot be implemented exactly, document the deviation and choose the closest FDS-aligned solution.
+
+## i18n and content
+
+- Do not hardcode user-facing copy in templates or script logic; use `t(...)` keys.
+- Add or update locale entries under the project’s language folder (for example `src/lang/*.json`) when introducing new text.
+- Keep translation keys descriptive and grouped by screen/feature.
+- Avoid storing i18n keys inside data/definition arrays (e.g. `i18nKey`) and translating later via dynamic keys or large switch statements. Prefer building definitions with already-translated `label: t('...')` (often as a `computed`) so types stay strict and templates stay simple.
+
+## Formatting and locale consistency
+
+- Prefer shared formatting utilities for date/number/currency output instead of ad-hoc inline formatting.
+- Use Swedish locale conventions (`sv-SE`) unless a feature explicitly requires another locale.
+
+## Accessibility baseline
+
+- Use semantic HTML and accessible FDS components first; avoid click-only `div`/`span` patterns.
+- Ensure form controls have proper labels and required ARIA attributes when needed.
+- All interactive elements must be keyboard reachable and show visible focus states.
+- Provide meaningful accessible names for icon-only actions and links.
+
+## Async UI states
+
+- For data-driven screens, always handle loading, empty, error, and success states explicitly.
+- Use consistent FDS-based feedback patterns for loaders, alerts, and empty-state messaging.
+
+## Error handling UX
+
+- Do not swallow errors silently; surface actionable feedback to users.
+- Use consistent FDS feedback patterns for API failures (alerts/toasts/inline messages).
+- Keep technical error details out of user-facing copy unless explicitly required.
+
+## Performance guardrails
+
+- Avoid unnecessary reactive churn (redundant watchers/computed chains in hot paths).
+- Memoize expensive derived values and keep render-time computations lightweight.
+- Keep route-level and heavy feature components lazy-loaded.
+
+## Security and data handling
+
+- Never commit or expose secrets, tokens, or sensitive identifiers in code, logs, or UI.
+- Validate and sanitize untrusted values from route/query params before use.
+- Type and validate outgoing payloads to prevent accidental over-posting.
+
+## Testing expectations
+
+- For non-trivial logic changes, add or update automated tests close to the affected feature.
+- Validate critical flows for changed views: loading, empty, error, and success states.
+- Keep tests behavior-focused and avoid brittle implementation-detail assertions.
+
+## CI/CD
+
+- Treat the repository’s CI configuration as the source of truth (`Jenkinsfile`, GitHub Actions, or equivalent).
+- Prefer frozen lockfile installs in CI (for example `pnpm install --frozen-lockfile --prefer-offline`) so CI matches local installs.
+- Keep build, lint, typecheck, and test stages deterministic; document any project-specific stages (security scans, i18n download, Docker publish) in the repo README or a dedicated rule file.
+
+## Quality checks before finishing
+
+- Run relevant checks for touched code (lint, typecheck, or tests when practical).
+- Fix issues introduced by your change before handing off.
+- Call out anything you could not verify.
+
+## Definition of done
+
+- Lint and type checks pass for touched code.
+- UI matches Figma/FDS expectations and uses tokenized styling.
+- i18n keys, async states, and cache behavior are handled for changed features.
+- Note any constraints, deviations, or unverified parts in handoff.
+
+## Legacy/deprecation policy
+
+- For new work, follow the current preferred patterns in this document.
+- Do not expand usage of known legacy patterns when a supported modern pattern exists.
+- If migration is out of scope, isolate legacy touchpoints and avoid spreading them.
+
+## Example: API data safety
+
+```ts
+// Prefer typed fallbacks when API data may be missing.
+const total = response?.stats?.total ?? 0
+```

package/LICENSE

@@ -0,0 +1,19 @@
+PROPRIETARY LICENSE
+
+Copyright (c) 2026 the authors
+
+All rights reserved.
+
+This software and associated documentation files (the "Software") are the
+proprietary and confidential property of the copyright holders.
+
+The Software is protected by copyright laws and international copyright
+treaties, as well as other intellectual property laws and treaties.
+
+Unauthorized copying, modification, distribution, or use of this Software,
+via any medium, is strictly prohibited and may result in severe civil and
+criminal penalties.
+
+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.

package/README.md

@@ -0,0 +1,13 @@
+# fg-devkit
+
+Shared settings and tools to improve the developer experience for Vue and TypeScript projects in the npm ecosystem.
+
+## Quick command alias (zsh)
+
+To run `fg` instead of `pnpm exec fg`, add this alias:
+
+```bash
+echo "alias fg='pnpm exec fg'" >> ~/.zshrc && source ~/.zshrc
+```
+
+This works in repos where `fg-devkit` is installed.

package/configs/dependency-policy.vue-workspace.json

@@ -0,0 +1,116 @@
+{
+  "managedDependencies": {
+    "dependencies": {
+      "@element-plus/icons-vue": "2.3.2",
+      "@lexical/html": "0.30.0",
+      "@lexical/list": "0.30.0",
+      "@lexical/rich-text": "0.30.0",
+      "@piwikpro/vue-piwik-pro": "1.4.0",
+      "@sentry/browser": "7.67.0",
+      "@sentry/tracing": "7.37.2",
+      "@sentry/vue": "7.37.2",
+      "@sentry/wasm": "7.67.0",
+      "@tailwindcss/postcss": "4.2.2",
+      "@tanstack/vue-query": "5.96.2",
+      "@types/leaflet": "1.5.7",
+      "@unhead/vue": "2.0.5",
+      "@vue-leaflet/vue-leaflet": "0.10.1",
+      "@vuelidate/core": "2.0.3",
+      "@vuelidate/validators": "2.0.4",
+      "@vueuse/components": "12.7.0",
+      "@vueuse/core": "14.2.1",
+      "chart.js": "4.5.1",
+      "content-disposition-header": "0.6.0",
+      "date-fns": "4.1.0",
+      "element-plus": "2.9.7",
+      "fds-vue-core": "6.2.1",
+      "imask": "7.6.1",
+      "leaflet": "1.8.0",
+      "lexical": "0.30.0",
+      "lodash": "4.17.23",
+      "lodash-es": "4.18.1",
+      "markdown-it": "14.1.1",
+      "pinia": "3.0.4",
+      "playwright": "1.57.0",
+      "quill": "2.0.3",
+      "randexp": "0.5.3",
+      "register-service-worker": "1.7.2",
+      "vega-embed": "7.1.0",
+      "vega-lite": "6.4.1",
+      "vue-chartjs": "5.3.3",
+      "vue-i18n": "11.3.2",
+      "vue-quilly": "1.0.5",
+      "vue-router": "4.6.3",
+      "vue3-touch-keyboard": "1.3.9",
+      "vuex": "4.1.0",
+      "vuex-persist": "3.1.3",
+      "yup": "1.7.1"
+    },
+    "devDependencies": {
+      "@chromatic-com/storybook": "5.0.1",
+      "@eslint/js": "9.39.1",
+      "@intlify/eslint-plugin-vue-i18n": "4.3.0",
+      "@intlify/unplugin-vue-i18n": "11.0.7",
+      "@playwright/test": "1.59.1",
+      "@rushstack/eslint-patch": "1.16.1",
+      "@storybook/addon-a11y": "10.1.10",
+      "@storybook/addon-docs": "10.1.10",
+      "@storybook/addon-vitest": "10.2.12",
+      "@storybook/vue3": "10.2.12",
+      "@storybook/vue3-vite": "10.2.12",
+      "@tanstack/vue-query-devtools": "6.1.13",
+      "@tsconfig/node22": "22.0.5",
+      "@types/lodash-es": "4.17.12",
+      "@types/node": "22.16.5",
+      "@typescript-eslint/eslint-plugin": "8.57.2",
+      "@typescript-eslint/parser": "8.57.2",
+      "@vitest/browser": "3.2.4",
+      "@vitest/eslint-plugin": "1.6.14",
+      "@vue/compiler-dom": "3.5.29",
+      "@vue/eslint-config-prettier": "10.2.0",
+      "@vue/eslint-config-standard": "8.0.1",
+      "@vue/eslint-config-typescript": "14.7.0",
+      "@vue/server-renderer": "3.5.29",
+      "@vue/test-utils": "2.4.6",
+      "@vue/tsconfig": "0.8.1",
+      "@vuepic/vue-datepicker": "6.0.3",
+      "arg": "5.0.2",
+      "babel-eslint": "10.1.0",
+      "commitizen": "4.3.1",
+      "eslint": "10.0.2",
+      "eslint-plugin-prettier": "5.5.5",
+      "eslint-plugin-storybook": "10.1.10",
+      "eslint-plugin-vue": "10.8.0",
+      "globals": "15.11.0",
+      "husky": "9.1.6",
+      "jsdom": "26.1.0",
+      "jsonc-eslint-parser": "2.4.1",
+      "lint-staged": "16.4.0",
+      "postcss": "8.5.6",
+      "prettier": "3.8.1",
+      "sass": "1.97.3",
+      "start-server-and-test": "2.1.3",
+      "storybook": "10.2.12",
+      "tsx": "4.21.0",
+      "typescript": "5.9.3",
+      "vega": "6.2.0",
+      "vite-plugin-dts": "4.5.4",
+      "vite-plugin-vue-devtools": "8.0.7",
+      "vitest": "3.2.4",
+      "vue-eslint-parser": "10.4.0",
+      "vue-tsc": "3.2.6",
+      "yaml": "2.8.3",
+      "yaml-eslint-parser": "1.3.1"
+    }
+  },
+  "managedAnywhere": {
+    "@tailwindcss/vite": "4.2.2",
+    "@vitejs/plugin-vue": "6.0.5",
+    "axios": "1.15.0",
+    "dotenv": "16.4.5",
+    "qrcode.vue": "3.8.1",
+    "tailwindcss": "4.2.2",
+    "vite": "7.3.2",
+    "vue": "3.5.32"
+  }
+}

package/configs/eslint.config.base.js

@@ -0,0 +1,262 @@
+// Base ESLint configuration for Vue / TypeScript FE repos
+// Extend this in your project's eslint.config.js
+
+import tseslint from '@typescript-eslint/eslint-plugin'
+import tsparser from '@typescript-eslint/parser'
+import pluginVitest from '@vitest/eslint-plugin'
+import skipFormatting from '@vue/eslint-config-prettier/skip-formatting'
+import pluginVue from 'eslint-plugin-vue'
+import { globalIgnores } from 'eslint/config'
+import vueParser from 'vue-eslint-parser'
+
+export default function createBaseConfig(options = {}) {
+  const {
+    tsconfigRootDir = process.cwd(),
+    tsconfigFiles = ['./tsconfig.json'],
+    additionalIgnores = [],
+    extraNonTypeAwareFiles = [],
+    enablePrettier = false,
+    enableI18n = false,
+    i18nLocaleDir = './src/lang/*.json',
+    additionalRules = {},
+    additionalPlugins = {},
+    additionalSettings = {},
+  } = options
+
+  // Note: Optional plugins should be imported by the consuming project
+  // This config accepts them via additionalPlugins option
+
+  const defaultAdditionalIgnores = [
+    'test-results/**',
+    'playwright-report/**',
+    'blob-report/**',
+    'playwright/.cache/**',
+    'reports/**',
+    '**/fg-devkit/configs/**',
+  ]
+
+  const configs = [
+    // Non-type-aware config for config files (must come first)
+    {
+      name: 'fg-devkit/config-files',
+      files: ['*.config.{ts,mts,js,mjs,cjs}', 'eslint.config.{js,ts}'],
+      languageOptions: {
+        parserOptions: {
+          project: null,
+          tsconfigRootDir,
+        },
+      },
+    },
+    {
+      name: 'fg-devkit/base',
+      files: ['**/*.{ts,mts,tsx,vue}'],
+    },
+    {
+      name: 'fg-devkit/vue-non-type-aware',
+      files: ['**/*.vue'],
+      languageOptions: {
+        parser: vueParser,
+        parserOptions: {
+          parser: tsparser,
+          project: null,
+        },
+      },
+    },
+    {
+      name: 'fg-devkit/typescript',
+      files: ['**/*.{ts,mts,tsx}'],
+      languageOptions: {
+        parser: tsparser,
+        parserOptions: {
+          project: null,
+        },
+      },
+      plugins: {
+        '@typescript-eslint': tseslint,
+      },
+    },
+    // Non-type-aware config for extra files outside tsconfig
+    ...(extraNonTypeAwareFiles.length
+      ? [
+          {
+            name: 'fg-devkit/extra-non-type-aware',
+            files: extraNonTypeAwareFiles,
+            languageOptions: {
+              parserOptions: {
+                project: null,
+                tsconfigRootDir,
+              },
+            },
+          },
+        ]
+      : []),
+    // Type-aware config for TypeScript files (if tsconfig files provided)
+    ...(tsconfigFiles && tsconfigFiles.length > 0
+      ? [
+          {
+            name: 'fg-devkit/type-aware',
+            files: ['src/**/*.{ts,mts,tsx}'],
+            languageOptions: {
+              parser: tsparser,
+              parserOptions: {
+                project: tsconfigFiles,
+                tsconfigRootDir,
+              },
+            },
+          },
+        ]
+      : []),
+    globalIgnores([
+      '**/dist/**',
+      '**/coverage/**',
+      '**/.storybook/**',
+      '**/node_modules/**',
+      '*.min.js',
+      'tsconfig.tsbuildinfo',
+      '.env.local',
+      '.env.*.local',
+      '*.config.cjs',
+      '.eslintrc.cjs',
+      ...defaultAdditionalIgnores,
+      ...additionalIgnores,
+    ]),
+    ...pluginVue.configs['flat/essential'],
+    {
+      ...pluginVitest.configs.recommended,
+      files: ['**/__tests__/**', '**/*.test.*', '**/*.spec.*'],
+    },
+    {
+      name: 'fg-devkit/rules',
+      files: ['**/*.vue', '**/*.js', '**/*.jsx', '**/*.cjs', '**/*.mjs', '**/*.ts', '**/*.tsx', '**/*.cts', '**/*.mts'],
+      plugins: {
+        '@typescript-eslint': tseslint,
+        ...additionalPlugins,
+      },
+      settings: {
+        ...(enableI18n
+          ? {
+              'vue-i18n': {
+                localeDir: {
+                  pattern: i18nLocaleDir,
+                  localeKey: 'file',
+                },
+              },
+            }
+          : {}),
+        ...additionalSettings,
+      },
+      rules: {
+        'vue/multi-word-component-names': 'off',
+        'vue/comment-directive': 'off',
+        'vue/no-deprecated-slot-attribute': 'off',
+        'no-console': ['error', { allow: ['warn', 'error'] }],
+        'arrow-body-style': ['warn', 'as-needed', { requireReturnForObjectLiteral: false }],
+        // Vue component recognition - allow fds-* components and router components
+        'vue/no-undef-components': [
+          'error',
+          {
+            ignorePatterns: ['^fds-', '^router-', '^Router', '^VueQuery'],
+          },
+        ],
+        'object-shorthand': ['error', 'always'],
+        'prefer-destructuring': [
+          'error',
+          {
+            array: false,
+            object: true,
+          },
+        ],
+        'prefer-arrow-callback': 'error',
+        'prefer-template': 'error',
+        'no-unused-expressions': 'error',
+        'no-useless-return': 'error',
+        'no-useless-concat': 'error',
+        '@typescript-eslint/no-unused-vars': [
+          'error',
+          {
+            argsIgnorePattern: '^_',
+            varsIgnorePattern: '^_',
+          },
+        ],
+        '@typescript-eslint/ban-ts-comment': 'off',
+        '@typescript-eslint/explicit-function-return-type': 'off',
+        '@typescript-eslint/no-var-requires': 'off',
+        'prefer-const': 'error',
+        'no-var': 'error',
+        'prefer-spread': 'error',
+        'prefer-rest-params': 'error',
+        'no-duplicate-imports': 'error',
+        'no-useless-rename': 'error',
+        'object-curly-spacing': ['error', 'always'],
+        'array-bracket-spacing': ['error', 'never'],
+        // Note: comma-dangle removed - Prettier handles trailing commas via trailingComma: 'all' setting
+        // skipFormatting at the end of config array disables formatting rules that conflict with Prettier
+        quotes: ['error', 'single', { avoidEscape: true }],
+        semi: ['error', 'never'],
+        'no-trailing-spaces': 'error',
+        'eol-last': 'error',
+        'no-lonely-if': 'error',
+        // Prettier integration (if enabled and plugin provided)
+        ...(enablePrettier && additionalPlugins.prettier ? { 'prettier/prettier': 'warn' } : {}),
+        // i18n rules (if enabled and plugin provided)
+        ...(enableI18n && additionalPlugins['@intlify/vue-i18n']
+          ? {
+              '@intlify/vue-i18n/no-missing-keys': 'error',
+              '@intlify/vue-i18n/no-raw-text': [
+                'error',
+                {
+                  attributes: {
+                    '/.+/': [
+                      'title',
+                      'aria-label',
+                      'aria-placeholder',
+                      'aria-roledescription',
+                      'aria-valuetext',
+                      'label',
+                      'placeholder',
+                      'alt',
+                      'meta',
+                    ],
+                    input: ['placeholder'],
+                    img: ['alt'],
+                  },
+                  ignorePattern: '^[-:/()%,.\'"]+$',
+                  ignoreNodes: ['md-icon', 'v-icon', 'fds-icon'],
+                },
+              ],
+              '@intlify/vue-i18n/no-unused-keys': [
+                'warn',
+                {
+                  src: './src',
+                  extensions: ['.js', '.vue', '.ts'],
+                  enableFix: false,
+                },
+              ],
+              '@intlify/vue-i18n/no-duplicate-keys-in-locale': 'error',
+              '@intlify/vue-i18n/no-dynamic-keys': 'warn',
+              '@intlify/vue-i18n/key-format-style': [
+                'warn',
+                'camelCase',
+                {
+                  allowArray: false,
+                  splitByDots: true,
+                },
+              ],
+            }
+          : {}),
+        // Additional project-specific rules
+        ...additionalRules,
+      },
+    },
+    // JS/CJS files config
+    {
+      files: ['**/*.js', '**/*.cjs'],
+      rules: {
+        '@typescript-eslint/no-var-requires': 'off',
+      },
+    },
+    skipFormatting,
+  ]
+
+  return configs
+}

package/configs/eslint.sync-stub.js

@@ -0,0 +1,19 @@
+/**
+ * Minimal ESLint flat config for apps using fg-devkit.
+ * Copied to eslint.config.js by sync-tooling-configs / sync-project-configs.
+ * Customize locally (plugins, rules) or pass options via createBaseConfig after syncing.
+ */
+import createBaseConfig from 'fg-devkit/eslint.config.base.js'
+import { fileURLToPath } from 'node:url'
+
+const tsconfigRootDir = fileURLToPath(new URL('.', import.meta.url))
+
+export default [
+  {
+    ignores: ['.yalc/**', '**/node_modules/**'],
+  },
+  ...createBaseConfig({
+    tsconfigRootDir,
+    tsconfigFiles: ['./tsconfig.json'],
+  }),
+]

package/configs/prettier.config.js

@@ -0,0 +1,16 @@
+/**
+ * Default Prettier options for repos that extend fg-devkit. Import or re-export from your own prettier.config.
+ */
+export default {
+  semi: false,
+  singleQuote: true,
+  printWidth: 120,
+  trailingComma: 'all',
+  tabWidth: 2,
+  useTabs: false,
+  arrowParens: 'always',
+  endOfLine: 'lf',
+  singleAttributePerLine: false,
+  bracketSameLine: false,
+  htmlWhitespaceSensitivity: 'ignore',
+}