create-zs3-app 1.0.0

package/templates/backend-ts/.editorconfig

@@ -0,0 +1,21 @@
+# EditorConfig: https://editorconfig.org
+
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_style = space
+indent_size = 2
+insert_final_newline = true
+trim_trailing_whitespace = true
+max_line_length = 150
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.json]
+indent_size = 2
+
+[*.{js,ts,jsx,tsx}]
+indent_size = 2

package/templates/backend-ts/.env.example

@@ -0,0 +1,2 @@
+PORT=3000
+NODE_ENV=development

package/templates/backend-ts/.prettierignore

@@ -0,0 +1,28 @@
+# Dependencies
+node_modules
+
+# Build output
+dist
+build
+coverage
+
+# Lock files
+package-lock.json
+yarn.lock
+pnpm-lock.yaml
+
+# Logs
+*.log
+
+# Environment
+.env
+.env.*
+
+# Cache
+.cache
+.eslintcache
+.prettierrc.cache
+
+# OS
+.DS_Store
+Thumbs.db

package/templates/backend-ts/.prettierrc

@@ -0,0 +1,13 @@
+{
+  "semi": false,
+  "trailingComma": "es5",
+  "singleQuote": true,
+  "printWidth": 150,
+  "tabWidth": 4,
+  "useTabs": false,
+  "arrowParens": "always",
+  "endOfLine": "lf",
+  "bracketSpacing": true,
+  "bracketSameLine": false,
+  "quoteProps": "as-needed"
+}

package/templates/backend-ts/README.md

@@ -0,0 +1,55 @@
+# Backend Project
+
+Backend amb TypeScript.
+
+## Requisits
+
+- Node.js >= 18
+- npm o yarn
+
+## Instal·lació
+
+```bash
+npm install
+```
+
+## Configuració
+
+Copia `.env.example` a `.env` i configura les variables d'entorn:
+
+```bash
+cp .env.example .env
+```
+
+## Scripts disponibles
+
+- `npm run dev` - Inicia el servidor en mode desenvolupament amb hot reload
+- `npm run build` - Compila el projecte a JavaScript
+- `npm start` - Inicia el servidor en mode producció
+- `npm run lint` - Executa el linter
+- `npm run lint:fix` - Corregeix automàticament els errors de linting
+- `npm run format` - Formata el codi amb Prettier
+- `npm run format:check` - Comprova el format del codi
+- `npm run type-check` - Comprova els tipus de TypeScript
+
+## Estructura del projecte
+
+```
+src/
+├── index.ts        # Punt d'entrada de l'aplicació
+```
+
+## Desenvolupament
+
+```bash
+npm run dev
+```
+
+El servidor s'executarà a `http://localhost:3000`
+
+## Producció
+
+```bash
+npm run build
+npm start
+```

package/templates/backend-ts/eslint.config.js

@@ -0,0 +1,43 @@
+import eslint from '@eslint/js'
+import prettierConfig from 'eslint-plugin-prettier/recommended'
+import globals from 'globals'
+import tseslint from 'typescript-eslint'
+
+export default [
+    { ignores: ['dist', 'node_modules', 'coverage', '*.js', '*.d.ts'] },
+    eslint.configs.recommended,
+    ...tseslint.configs.recommendedTypeChecked,
+    {
+        // Configuració global per a tots els fitxers
+        languageOptions: {
+            globals: {
+                ...globals.node,
+                ...globals.jest,
+            },
+            parserOptions: {
+                project: true,
+                tsconfigRootDir: import.meta.dirname,
+            },
+        },
+        // Regles que vols aplicar
+        rules: {
+            'prettier/prettier': 'error',
+            semi: ['error', 'never'],
+            '@typescript-eslint/no-explicit-any': 'error',
+            '@typescript-eslint/explicit-function-return-type': 'warn',
+            '@typescript-eslint/explicit-module-boundary-types': 'warn',
+            '@typescript-eslint/no-unused-vars': [
+                'error',
+                {
+                    argsIgnorePattern: '^_',
+                    varsIgnorePattern: '^_',
+                },
+            ],
+            '@typescript-eslint/no-floating-promises': 'error',
+            '@typescript-eslint/strict-boolean-expressions': 'off',
+            '@typescript-eslint/prefer-nullish-coalescing': 'warn',
+            '@typescript-eslint/prefer-optional-chain': 'warn',
+        },
+    },
+    prettierConfig, // Aquesta ha de ser l'última configuració per sobreescriure regles d'estil
+]

package/templates/backend-ts/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "backend-project",
+  "version": "1.0.0",
+  "description": "Backend project with TypeScript",
+  "main": "dist/index.js",
+  "type": "module",
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\"",
+    "type-check": "tsc --noEmit"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "dotenv": "^16.3.1"
+  },
+  "devDependencies": {
+    "@eslint/js": "9.39.2",
+    "@types/node": "^20.10.0",
+    "eslint": "9.39.2",
+    "eslint-config-prettier": "^10.1.5",
+    "eslint-plugin-prettier": "^5.0.1",
+    "globals": "^16.1.0",
+    "prettier": "3.8.1",
+    "tsx": "^4.7.0",
+    "typescript": "5.9.3",
+    "typescript-eslint": "8.53.1"
+  }
+}

package/templates/backend-ts/src/index.ts

@@ -0,0 +1,7 @@
+import dotenv from 'dotenv'
+
+dotenv.config()
+
+const port = process.env.PORT || 3000
+
+console.log(`Running on: ${port}`);

package/templates/backend-ts/tsconfig.json

@@ -0,0 +1,25 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ES2022",
+    "lib": ["ES2022"],
+    "moduleResolution": "node",
+    "rootDir": "./src",
+    "outDir": "./dist",
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "allowSyntheticDefaultImports": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/templates/backend-ts-express/.editorconfig

@@ -0,0 +1,21 @@
+# EditorConfig: https://editorconfig.org
+
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_style = space
+indent_size = 2
+insert_final_newline = true
+trim_trailing_whitespace = true
+max_line_length = 150
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.json]
+indent_size = 2
+
+[*.{js,ts,jsx,tsx}]
+indent_size = 2

package/templates/backend-ts-express/.env.example

@@ -0,0 +1,2 @@
+PORT=3000
+NODE_ENV=development

package/templates/backend-ts-express/.prettierignore

@@ -0,0 +1,28 @@
+# Dependencies
+node_modules
+
+# Build output
+dist
+build
+coverage
+
+# Lock files
+package-lock.json
+yarn.lock
+pnpm-lock.yaml
+
+# Logs
+*.log
+
+# Environment
+.env
+.env.*
+
+# Cache
+.cache
+.eslintcache
+.prettierrc.cache
+
+# OS
+.DS_Store
+Thumbs.db

package/templates/backend-ts-express/.prettierrc

@@ -0,0 +1,13 @@
+{
+  "semi": false,
+  "trailingComma": "es5",
+  "singleQuote": true,
+  "printWidth": 150,
+  "tabWidth": 4,
+  "useTabs": false,
+  "arrowParens": "always",
+  "endOfLine": "lf",
+  "bracketSpacing": true,
+  "bracketSameLine": false,
+  "quoteProps": "as-needed"
+}

package/templates/backend-ts-express/README.md

@@ -0,0 +1,59 @@
+# Backend Project
+
+Backend amb Express i TypeScript.
+
+## Requisits
+
+- Node.js >= 18
+- npm o yarn
+
+## Instal·lació
+
+```bash
+npm install
+```
+
+## Configuració
+
+Copia `.env.example` a `.env` i configura les variables d'entorn:
+
+```bash
+cp .env.example .env
+```
+
+## Scripts disponibles
+
+- `npm run dev` - Inicia el servidor en mode desenvolupament amb hot reload
+- `npm run build` - Compila el projecte a JavaScript
+- `npm start` - Inicia el servidor en mode producció
+- `npm run lint` - Executa el linter
+- `npm run lint:fix` - Corregeix automàticament els errors de linting
+- `npm run format` - Formata el codi amb Prettier
+- `npm run format:check` - Comprova el format del codi
+- `npm run type-check` - Comprova els tipus de TypeScript
+
+## Estructura del projecte
+
+```
+src/
+├── index.ts        # Punt d'entrada de l'aplicació (Express server)
+```
+
+## Desenvolupament
+
+```bash
+npm run dev
+```
+
+El servidor s'executarà a `http://localhost:3000`
+
+## API
+
+- `GET /` - Retorna un missatge de benvinguda
+
+## Producció
+
+```bash
+npm run build
+npm start
+```

package/templates/backend-ts-express/eslint.config.js

@@ -0,0 +1,43 @@
+import eslint from '@eslint/js'
+import prettierConfig from 'eslint-plugin-prettier/recommended'
+import globals from 'globals'
+import tseslint from 'typescript-eslint'
+
+export default [
+    { ignores: ['dist', 'node_modules', 'coverage', '*.js', '*.d.ts'] },
+    eslint.configs.recommended,
+    ...tseslint.configs.recommendedTypeChecked,
+    {
+        // Configuració global per a tots els fitxers
+        languageOptions: {
+            globals: {
+                ...globals.node,
+                ...globals.jest,
+            },
+            parserOptions: {
+                project: true,
+                tsconfigRootDir: import.meta.dirname,
+            },
+        },
+        // Regles que vols aplicar
+        rules: {
+            'prettier/prettier': 'error',
+            semi: ['error', 'never'],
+            '@typescript-eslint/no-explicit-any': 'error',
+            '@typescript-eslint/explicit-function-return-type': 'warn',
+            '@typescript-eslint/explicit-module-boundary-types': 'warn',
+            '@typescript-eslint/no-unused-vars': [
+                'error',
+                {
+                    argsIgnorePattern: '^_',
+                    varsIgnorePattern: '^_',
+                },
+            ],
+            '@typescript-eslint/no-floating-promises': 'error',
+            '@typescript-eslint/strict-boolean-expressions': 'off',
+            '@typescript-eslint/prefer-nullish-coalescing': 'warn',
+            '@typescript-eslint/prefer-optional-chain': 'warn',
+        },
+    },
+    prettierConfig, // Aquesta ha de ser l'última configuració per sobreescriure regles d'estil
+]

package/templates/backend-ts-express/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "backend-project",
+  "version": "1.0.0",
+  "description": "Backend project with Express and TypeScript",
+  "main": "dist/index.js",
+  "type": "module",
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\"",
+    "type-check": "tsc --noEmit"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "dotenv": "^16.3.1",
+    "express": "^4.18.2"
+  },
+  "devDependencies": {
+    "@eslint/js": "9.39.2",
+    "@types/express": "^4.17.21",
+    "@types/node": "^20.10.0",
+    "eslint": "9.39.2",
+    "eslint-config-prettier": "^10.1.5",
+    "eslint-plugin-prettier": "^5.0.1",
+    "globals": "^16.1.0",
+    "prettier": "3.8.1",
+    "tsx": "^4.7.0",
+    "typescript": "5.9.3",
+    "typescript-eslint": "8.53.1"
+  }
+}

package/templates/backend-ts-express/src/index.ts

@@ -0,0 +1,17 @@
+import dotenv from 'dotenv'
+import express from 'express'
+
+dotenv.config()
+
+const app = express()
+const port = process.env.PORT || 3000
+
+app.use(express.json())
+
+app.get('/', (_req, res) => {
+  res.json({ message: 'Backend funcionant correctament!' })
+})
+
+app.listen(port, () => {
+  console.log(`Server running on http://localhost:${port}`)
+})

package/templates/backend-ts-express/tsconfig.json

@@ -0,0 +1,25 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ES2022",
+    "lib": ["ES2022"],
+    "moduleResolution": "node",
+    "rootDir": "./src",
+    "outDir": "./dist",
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "allowSyntheticDefaultImports": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/templates/backend-vanilla/.editorconfig

@@ -0,0 +1,21 @@
+# EditorConfig: https://editorconfig.org
+
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_style = space
+indent_size = 2
+insert_final_newline = true
+trim_trailing_whitespace = true
+max_line_length = 150
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.json]
+indent_size = 2
+
+[*.{js,ts,jsx,tsx}]
+indent_size = 2

package/templates/backend-vanilla/.env.example

@@ -0,0 +1,2 @@
+PORT=3000
+NODE_ENV=development

package/templates/backend-vanilla/.prettierignore

@@ -0,0 +1,28 @@
+# Dependencies
+node_modules
+
+# Build output
+dist
+build
+coverage
+
+# Lock files
+package-lock.json
+yarn.lock
+pnpm-lock.yaml
+
+# Logs
+*.log
+
+# Environment
+.env
+.env.*
+
+# Cache
+.cache
+.eslintcache
+.prettierrc.cache
+
+# OS
+.DS_Store
+Thumbs.db

package/templates/backend-vanilla/.prettierrc

@@ -0,0 +1,13 @@
+{
+  "semi": false,
+  "trailingComma": "es5",
+  "singleQuote": true,
+  "printWidth": 150,
+  "tabWidth": 4,
+  "useTabs": false,
+  "arrowParens": "always",
+  "endOfLine": "lf",
+  "bracketSpacing": true,
+  "bracketSameLine": false,
+  "quoteProps": "as-needed"
+}

package/templates/backend-vanilla/README.md

@@ -0,0 +1,46 @@
+# Backend Project
+
+Backend amb JavaScript.
+
+## Requisits
+
+- Node.js >= 18
+- npm o yarn
+
+## Instal·lació
+
+```bash
+npm install
+```
+
+## Configuració
+
+Copia `.env.example` a `.env` i configura les variables d'entorn:
+
+```bash
+cp .env.example .env
+```
+
+## Scripts disponibles
+
+- `npm run dev` - Inicia el servidor en mode desenvolupament amb hot reload
+- `npm start` - Inicia el servidor en mode producció
+- `npm run lint` - Executa el linter
+- `npm run lint:fix` - Corregeix automàticament els errors de linting
+- `npm run format` - Formata el codi amb Prettier
+- `npm run format:check` - Comprova el format del codi
+
+## Estructura del projecte
+
+```
+src/
+├── index.js        # Punt d'entrada de l'aplicació
+```
+
+## Desenvolupament
+
+```bash
+npm run dev
+```
+
+El servidor s'executarà a `http://localhost:3000`

package/templates/backend-vanilla/eslint.config.js

@@ -0,0 +1,27 @@
+import eslint from '@eslint/js'
+import prettierConfig from 'eslint-plugin-prettier/recommended'
+import globals from 'globals'
+
+export default [
+    { ignores: ['dist', 'node_modules', 'coverage'] },
+    eslint.configs.recommended,
+    {
+        languageOptions: {
+            globals: {
+                ...globals.node,
+            },
+        },
+        rules: {
+            'prettier/prettier': 'error',
+            semi: ['error', 'never'],
+            'no-unused-vars': [
+                'error',
+                {
+                    argsIgnorePattern: '^_',
+                    varsIgnorePattern: '^_',
+                },
+            ],
+        },
+    },
+    prettierConfig,
+]

package/templates/backend-vanilla/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "backend-project",
+  "version": "1.0.0",
+  "description": "Backend project with JavaScript",
+  "main": "src/index.js",
+  "type": "module",
+  "scripts": {
+    "dev": "node --watch src/index.js",
+    "start": "node src/index.js",
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix",
+    "format": "prettier --write \"src/**/*.js\"",
+    "format:check": "prettier --check \"src/**/*.js\""
+  },
+  "keywords": [],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "dotenv": "^16.3.1"
+  },
+  "devDependencies": {
+    "@eslint/js": "9.39.2",
+    "eslint": "9.39.2",
+    "eslint-config-prettier": "^10.1.5",
+    "eslint-plugin-prettier": "^5.0.1",
+    "globals": "^16.1.0",
+    "prettier": "3.8.1"
+  }
+}

package/templates/backend-vanilla/src/index.js

@@ -0,0 +1,7 @@
+import dotenv from 'dotenv'
+
+dotenv.config()
+
+const port = process.env.PORT || 3000
+
+console.log(`Running on: ${port}`)