@korioinc/next-configs 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Korio Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,85 @@
+# @korioinc/next-configs
+
+Shared configuration presets for ESLint, Prettier, and TypeScript in Next.js projects.
+
+## Installation
+
+```bash
+pnpm add -D @korioinc/next-configs
+```
+
+## Features
+
+- **ESLint Configs**: Pre-configured ESLint rules for Next.js, libraries, and React libraries
+- **Prettier Config**: Consistent code formatting with Tailwind CSS support
+- **TypeScript Configs**: Optimized tsconfig presets for different project types
+
+## Usage
+
+### ESLint Configuration
+
+Create an `eslint.config.mjs` file:
+
+```javascript
+import nextConfig from '@korioinc/next-configs/eslint/next';
+
+export default nextConfig;
+```
+
+Available presets:
+- `@korioinc/next-configs/eslint/base` - Base configuration
+- `@korioinc/next-configs/eslint/next` - Next.js applications
+- `@korioinc/next-configs/eslint/library` - Node.js libraries
+- `@korioinc/next-configs/eslint/react-library` - React component libraries
+
+### Prettier Configuration
+
+Create a `prettier.config.mjs` file:
+
+```javascript
+import prettierConfig from '@korioinc/next-configs/prettier';
+
+export default prettierConfig;
+```
+
+Features included:
+- Import sorting with `@trivago/prettier-plugin-sort-imports`
+- Tailwind CSS class sorting with `prettier-plugin-tailwindcss`
+
+### TypeScript Configuration
+
+Extend from our presets in your `tsconfig.json`:
+
+```json
+{
+  "extends": "@korioinc/next-configs/tsconfig/nextjs"
+}
+```
+
+Available presets:
+- `/tsconfig/base.json` - Base TypeScript configuration
+- `/tsconfig/nextjs.json` - Next.js applications
+- `/tsconfig/library.json` - Node.js libraries
+- `/tsconfig/react-library.json` - React component libraries
+
+## Peer Dependencies
+
+This package requires the following peer dependencies:
+
+- `eslint` >=9.0.0
+- `typescript` >=5.9.0
+- `prettier` >=3.0.0
+
+For full functionality, you may also need:
+- `@next/eslint-plugin-next` >=15.0.0
+- `@typescript-eslint/eslint-plugin` >=8.41.0
+- `eslint-plugin-react` >=7.37.0
+- `prettier-plugin-tailwindcss` >=0.6.0
+
+## License
+
+MIT
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.

package/eslint/base.mjs

@@ -0,0 +1,29 @@
+import js from '@eslint/js';
+
+import eslintConfigPrettier from 'eslint-config-prettier';
+import turboPlugin from 'eslint-plugin-turbo';
+import tseslint from 'typescript-eslint';
+
+/**
+ * Base (non-Next) ESLint config
+ * Mirrors the previous packages/eslint-config/base.js (without any onlyWarn option).
+ * @type {import('eslint').Linter.Config[]}
+ */
+export const config = [
+  js.configs.recommended,
+  eslintConfigPrettier,
+  ...tseslint.configs.recommended,
+  {
+    plugins: {
+      turbo: turboPlugin,
+    },
+    rules: {
+      'turbo/no-undeclared-env-vars': 'warn',
+    },
+  },
+  {
+    ignores: ['dist/**'],
+  },
+];
+
+export default config;

package/eslint/library.mjs

@@ -0,0 +1,79 @@
+import pluginJs from '@eslint/js';
+import typescriptEslint from '@typescript-eslint/eslint-plugin';
+import typescriptParser from '@typescript-eslint/parser';
+
+import { config as baseConfig } from './base.mjs';
+import eslintConfigPrettier from 'eslint-config-prettier';
+import importPlugin from 'eslint-plugin-import';
+import prettier from 'eslint-plugin-prettier';
+import pluginPromise from 'eslint-plugin-promise';
+import valtio from 'eslint-plugin-valtio';
+import globals from 'globals';
+import tseslint from 'typescript-eslint';
+
+/** @type {import('eslint').Linter.Config[]} */
+const config = [
+  // Reuse base rules
+  ...baseConfig,
+  {
+    files: ['**/*.{js,mjs,cjs,ts,jsx,tsx}'],
+  },
+  {
+    languageOptions: {
+      ecmaVersion: 'latest',
+      globals: {
+        ...globals.browser,
+        ...globals.node,
+        ...globals.serviceworker,
+      },
+      sourceType: 'module',
+      parser: typescriptParser,
+    },
+  },
+  pluginJs.configs.recommended, // ? https://github.com/eslint/eslint
+  importPlugin.flatConfigs.recommended, // ? https://github.com/import-js/eslint-plugin-import
+  ...tseslint.configs.recommended, // ? https://github.com/typescript-eslint/typescript-eslint
+  pluginPromise.configs['flat/recommended'], // ? https://github.com/eslint-community/eslint-plugin-promise
+  eslintConfigPrettier, // ? https://github.com/prettier/eslint-config-prettier
+  {
+    rules: {
+      'no-unused-vars': 'off',
+      'newline-before-return': 'error',
+      '@typescript-eslint/no-unused-vars': 'off',
+      '@typescript-eslint/no-unused-expressions': 'off',
+      'import/no-unresolved': 'off',
+      'import/no-named-as-default': 'off',
+    },
+  },
+  // valtio
+  valtio.configs['flat/recommended'],
+  {
+    rules: {
+      'valtio/state-snapshot-rule': ['warn'],
+      'valtio/avoid-this-in-proxy': ['warn'],
+    },
+  },
+  // ! ===================== DISCLAIMER =====================
+  // ! There is no official solution available for new ESLint 9 flat config structure for NextJS
+  // ! The solution is taken from the community and may not be the best practice, use it at your own risk
+  // ? Ref: https://github.com/vercel/next.js/discussions/49337?sort=top#discussioncomment-5998603
+  // ! ======================================================
+  {
+    plugins: {
+      prettier,
+      '@typescript-eslint': typescriptEslint,
+    },
+    rules: {
+      // Prettier
+      'prettier/prettier': 'error',
+
+      // General
+      'no-console': 'off',
+    },
+  },
+  {
+    ignores: ['dist/**', 'node_modules/**'],
+  },
+];
+
+export default config;

package/eslint/next.mjs

@@ -0,0 +1,100 @@
+import pluginJs from '@eslint/js';
+import nextPlugin from '@next/eslint-plugin-next';
+import typescriptEslint from '@typescript-eslint/eslint-plugin';
+import typescriptParser from '@typescript-eslint/parser';
+
+import { config as baseConfig } from './base.mjs';
+import eslintConfigPrettier from 'eslint-config-prettier';
+import importPlugin from 'eslint-plugin-import';
+import prettier from 'eslint-plugin-prettier';
+import pluginPromise from 'eslint-plugin-promise';
+import pluginReact from 'eslint-plugin-react';
+import valtio from 'eslint-plugin-valtio';
+import globals from 'globals';
+import tseslint from 'typescript-eslint';
+
+/** @type {import('eslint').Linter.Config[]} */
+const config = [
+  // Reuse base rules
+  ...baseConfig,
+  {
+    files: ['**/*.{js,mjs,cjs,ts,jsx,tsx}'],
+  },
+  {
+    languageOptions: {
+      ecmaVersion: 'latest',
+      globals: {
+        ...globals.browser,
+        ...globals.node,
+        ...globals.serviceworker,
+      },
+      sourceType: 'module',
+      parser: typescriptParser,
+    },
+  },
+  {
+    settings: {
+      react: {
+        version: 'detect',
+      },
+    },
+  },
+  pluginJs.configs.recommended, // ? https://github.com/eslint/eslint
+  importPlugin.flatConfigs.recommended, // ? https://github.com/import-js/eslint-plugin-import
+  ...tseslint.configs.recommended, // ? https://github.com/typescript-eslint/typescript-eslint
+  pluginPromise.configs['flat/recommended'], // ? https://github.com/eslint-community/eslint-plugin-promise
+  pluginReact.configs.flat.recommended, // ? https://github.com/jsx-eslint/eslint-plugin-react
+  pluginReact.configs.flat['jsx-runtime'], // ? https://github.com/jsx-eslint/eslint-plugin-react
+  eslintConfigPrettier, // ? https://github.com/prettier/eslint-config-prettier
+  {
+    rules: {
+      'no-unused-vars': 'off',
+      'react/react-in-jsx-scope': 'off',
+      'react-hooks/exhaustive-deps': 'off',
+      'react/display-name': 'off',
+      'react/prop-types': 'off',
+      'newline-before-return': 'error',
+      '@typescript-eslint/no-unused-vars': 'off',
+      '@typescript-eslint/no-unused-expressions': 'off',
+      'import/no-unresolved': 'off',
+      'import/no-named-as-default': 'off',
+      'react/no-unescaped-entities': 'off',
+    },
+  },
+  // valtio
+  valtio.configs['flat/recommended'],
+  {
+    rules: {
+      'valtio/state-snapshot-rule': ['warn'],
+      'valtio/avoid-this-in-proxy': ['warn'],
+    },
+  },
+  // ! ===================== DISCLAIMER =====================
+  // ! There is no official solution available for new ESLint 9 flat config structure for NextJS
+  // ! The solution is taken from the community and may not be the best practice, use it at your own risk
+  // ? Ref: https://github.com/vercel/next.js/discussions/49337?sort=top#discussioncomment-5998603
+  // ! ======================================================
+  {
+    plugins: {
+      '@next/next': nextPlugin,
+      prettier,
+      '@typescript-eslint': typescriptEslint,
+    },
+    rules: {
+      ...nextPlugin.configs.recommended.rules,
+      ...nextPlugin.configs['core-web-vitals'].rules,
+      '@next/next/no-img-element': 'off',
+
+      // Prettier
+      'prettier/prettier': 'error',
+
+      // General
+      'no-console': 'off',
+    },
+  },
+  {
+    ignores: ['.next/*', 'dist/**'],
+  },
+];
+
+export default config;

package/eslint/react-library.mjs

@@ -0,0 +1,94 @@
+import pluginJs from '@eslint/js';
+import typescriptEslint from '@typescript-eslint/eslint-plugin';
+import typescriptParser from '@typescript-eslint/parser';
+
+import { config as baseConfig } from './base.mjs';
+import eslintConfigPrettier from 'eslint-config-prettier';
+import importPlugin from 'eslint-plugin-import';
+import prettier from 'eslint-plugin-prettier';
+import pluginPromise from 'eslint-plugin-promise';
+import pluginReact from 'eslint-plugin-react';
+import valtio from 'eslint-plugin-valtio';
+import globals from 'globals';
+import tseslint from 'typescript-eslint';
+
+/** @type {import('eslint').Linter.Config[]} */
+const config = [
+  // Reuse base rules
+  ...baseConfig,
+  {
+    files: ['**/*.{js,mjs,cjs,ts,jsx,tsx}'],
+  },
+  {
+    languageOptions: {
+      ecmaVersion: 'latest',
+      globals: {
+        ...globals.browser,
+        ...globals.node,
+        ...globals.serviceworker,
+      },
+      sourceType: 'module',
+      parser: typescriptParser,
+    },
+  },
+  {
+    settings: {
+      react: {
+        version: 'detect',
+      },
+    },
+  },
+  pluginJs.configs.recommended, // ? https://github.com/eslint/eslint
+  importPlugin.flatConfigs.recommended, // ? https://github.com/import-js/eslint-plugin-import
+  ...tseslint.configs.recommended, // ? https://github.com/typescript-eslint/typescript-eslint
+  pluginPromise.configs['flat/recommended'], // ? https://github.com/eslint-community/eslint-plugin-promise
+  pluginReact.configs.flat.recommended, // ? https://github.com/jsx-eslint/eslint-plugin-react
+  pluginReact.configs.flat['jsx-runtime'], // ? https://github.com/jsx-eslint/eslint-plugin-react
+  eslintConfigPrettier, // ? https://github.com/prettier/eslint-config-prettier
+  {
+    rules: {
+      'no-unused-vars': 'off',
+      'react/react-in-jsx-scope': 'off',
+      'react-hooks/exhaustive-deps': 'off',
+      'react/display-name': 'off',
+      'react/prop-types': 'off',
+      'newline-before-return': 'error',
+      '@typescript-eslint/no-unused-vars': 'off',
+      '@typescript-eslint/no-unused-expressions': 'off',
+      'import/no-unresolved': 'off',
+      'import/no-named-as-default': 'off',
+      'react/no-unescaped-entities': 'off',
+    },
+  },
+  // valtio
+  valtio.configs['flat/recommended'],
+  {
+    rules: {
+      'valtio/state-snapshot-rule': ['warn'],
+      'valtio/avoid-this-in-proxy': ['warn'],
+    },
+  },
+  // ! ===================== DISCLAIMER =====================
+  // ! There is no official solution available for new ESLint 9 flat config structure for NextJS
+  // ! The solution is taken from the community and may not be the best practice, use it at your own risk
+  // ? Ref: https://github.com/vercel/next.js/discussions/49337?sort=top#discussioncomment-5998603
+  // ! ======================================================
+  {
+    plugins: {
+      prettier,
+      '@typescript-eslint': typescriptEslint,
+    },
+    rules: {
+      // Prettier
+      'prettier/prettier': 'error',
+
+      // General
+      'no-console': 'off',
+    },
+  },
+  {
+    ignores: ['dist/**', 'node_modules/**'],
+  },
+];
+
+export default config;

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@korioinc/next-configs",
+  "version": "1.0.0",
+  "type": "module",
+  "scripts": {
+    "lint": "eslint . --max-warnings 0"
+  },
+  "exports": {
+    "./eslint": "./eslint/next.mjs",
+    "./eslint/base": "./eslint/base.mjs",
+    "./eslint/next": "./eslint/next.mjs",
+    "./eslint/library": "./eslint/library.mjs",
+    "./eslint/react-library": "./eslint/react-library.mjs",
+    "./prettier": "./prettier/index.mjs",
+    "./tsconfig/*": "./tsconfig/*.json"
+  },
+  "files": [
+    "eslint",
+    "prettier",
+    "tsconfig",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/korioinc/korio-nextjs-kit.git",
+    "directory": "packages/configs"
+  },
+  "author": "Korio Inc.",
+  "license": "MIT",
+  "peerDependencies": {
+    "globals": ">=16.0.0",
+    "eslint": ">=9.0.0",
+    "@eslint/js": ">=9.0.0",
+    "@next/eslint-plugin-next": ">=15.0.0",
+    "@typescript-eslint/eslint-plugin": ">=8.41.0",
+    "@typescript-eslint/parser": ">=8.41.0",
+    "eslint-config-prettier": ">=10.0.0",
+    "eslint-plugin-import": ">=2.32.0",
+    "eslint-plugin-prettier": ">=5.5.0",
+    "eslint-plugin-promise": ">=7.2.0",
+    "eslint-plugin-react": ">=7.37.0",
+    "eslint-plugin-react-hooks": ">=5.2.0",
+    "eslint-plugin-turbo": ">=2.5.0",
+    "typescript": ">=5.9.0",
+    "typescript-eslint": ">=8.41.0",
+    "prettier": ">=3.0.0",
+    "@trivago/prettier-plugin-sort-imports": ">=5.0.0",
+    "prettier-plugin-tailwindcss": ">=0.6.0"
+  }
+}

package/prettier/index.mjs

@@ -0,0 +1,22 @@
+export default {
+  arrowParens: 'always',
+  bracketSpacing: true,
+  htmlWhitespaceSensitivity: 'css',
+  insertPragma: false,
+  bracketSameLine: true,
+  jsxSingleQuote: true,
+  printWidth: 120,
+  proseWrap: 'preserve',
+  quoteProps: 'as-needed',
+  requirePragma: false,
+  semi: true,
+  singleQuote: true,
+  tabWidth: 2,
+  trailingComma: 'all',
+  useTabs: false,
+  endOfLine: 'auto',
+  plugins: ['@trivago/prettier-plugin-sort-imports', 'prettier-plugin-tailwindcss'],
+  importOrder: ['^react$', '^next(/.*)?$', 'next-themes', '@/*', '<THIRD_PARTY_MODULES>'],
+  importOrderSeparation: true,
+  importOrderSortSpecifiers: true,
+};

package/tsconfig/base.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "compilerOptions": {
+    "declaration": true,
+    "declarationMap": true,
+    "esModuleInterop": true,
+    "incremental": false,
+    "isolatedModules": true,
+    "lib": ["es2022", "DOM", "DOM.Iterable"],
+    "module": "NodeNext",
+    "moduleDetection": "force",
+    "moduleResolution": "NodeNext",
+    "noUncheckedIndexedAccess": true,
+    "resolveJsonModule": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "target": "ES2022"
+  }
+}

package/tsconfig/nextjs.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "./base.json",
+  "compilerOptions": {
+    "plugins": [{ "name": "next" }],
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "allowJs": true,
+    "jsx": "preserve",
+    "noEmit": true,
+    "noUncheckedIndexedAccess": false
+  }
+}

package/tsconfig/react-library.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "./base.json",
+  "compilerOptions": {
+    "jsx": "react-jsx",
+    "module": "ESNext",
+    "moduleResolution": "Bundler"
+  }
+}