Configuration

{
  "packageManager": "pnpm",
  "tailwind": true,
  "linterFormatter": "eslint-prettier",
  "docker": "dev",
  "uiLibrary": "shadcn",
  "gitSetup": true
}

# Edit avangclirc.json in project root
{
  "packageManager": "pnpm"
}

# Without configuration
avangcli init my-app
# → Asks which package manager to use

# With project configuration
avangcli init my-app
# → Uses configured package manager automatically

# During module creation
avangcli module users --store redux -p

# Or manually in avangclirc.json
{
  "defaultStoreManager": "redux"
}

# Without configuration
avangcli module products
# → Asks which store manager to use

# With project configuration
avangcli module products
# → Uses configured store manager automatically

{
  "defaultLinterFormatter": "biome"
}

{
  "defaultUiLibrary": "shadcn"
}

# project/avangclirc.json
{
  "packageManager": "pnpm",
  "defaultStoreManager": "redux"
}

# Command
avangcli module products --pm bun

# Result:
# - Package manager: bun (CLI argument)
# - Store manager: redux (project config)

# 1. Create first project
avangcli init my-app --pm bun --ui shadcn

# 2. Set store manager as project default
cd my-app
avangcli module auth --store zustand -p

# 3. All future modules use zustand
avangcli module products  # → uses zustand
avangcli module cart      # → uses zustand

# View project configuration
cat avangclirc.json

# Project
code avangclirc.json

# Project
rm avangclirc.json

# Automatically detects configuration and regenerates avangclirc.json
avangcli config

{
  "defaultPackageManager": "bun",
  "defaultStoreManager": "zustand",
  "defaultLinterFormatter": "biome",
  "defaultUiLibrary": "shadcn"
}

{
  "defaultPackageManager": "pnpm",
  "defaultStoreManager": "redux",
  "defaultLinterFormatter": "eslint-prettier",
  "defaultUiLibrary": "mui"
}

{
  "defaultPackageManager": "bun",
  "defaultStoreManager": "zustand",
  "defaultLinterFormatter": "biome",
  "defaultUiLibrary": "shadcn"
}

# .env.local
NEXT_PUBLIC_API_URL=http://localhost:3001/api
NEXT_PUBLIC_APP_NAME=MyApp
NEXT_PUBLIC_ENV=development

# Private (server only)
DATABASE_URL=postgresql://...
API_SECRET_KEY=...

// modules/products/services/products.service.ts
export class ProductsService {
  private apiUrl = process.env.NEXT_PUBLIC_API_URL!

  async fetchProducts() {
    return fetch(`${this.apiUrl}/products`)
  }
}

{
  "extends": ["next/core-web-vitals", "prettier"],
  "rules": {
    "no-console": "warn",
    "@typescript-eslint/no-unused-vars": "error",
    "prefer-const": "error"
  }
}

{
  "semi": false,
  "singleQuote": true,
  "tabWidth": 2,
  "trailingComma": "es5",
  "printWidth": 100,
  "arrowParens": "always"
}

{
  "compilerOptions": {
    "target": "ES2020",
    "lib": ["ES2020", "DOM", "DOM.Iterable"],
    "jsx": "preserve",
    "module": "ESNext",
    "moduleResolution": "bundler",
    "resolveJsonModule": true,
    "isolatedModules": true,
    "noEmit": true,
    "esModuleInterop": true,
    "strict": true,
    "skipLibCheck": true,
    "paths": {
      "@/*": ["./*"],
      "@/modules/*": ["./modules/*"],
      "@/shared/*": ["./shared/*"]
    }
  }
}

import type { Config } from "tailwindcss"

const config: Config = {
  content: [
    "./app/**/*.{js,ts,jsx,tsx,mdx}",
    "./modules/**/*.{js,ts,jsx,tsx,mdx}",
    "./components/**/*.{js,ts,jsx,tsx,mdx}"
  ],
  theme: {
    extend: {
      colors: {
        primary: "#0070f3",
        secondary: "#7928ca"
      }
    }
  },
  plugins: []
}

export default config

# .husky/pre-commit
#!/bin/sh
. "$(dirname "$0")/_/husky.sh"

bun run lint
bun run type-check

# .husky/commit-msg
#!/bin/sh
. "$(dirname "$0")/_/husky.sh"

npx --no -- commitlint --edit "$1"

module.exports = {
  extends: ["@commitlint/config-conventional"],
  rules: {
    "type-enum": [2, "always", ["feat", "fix", "docs", "style", "refactor", "test", "chore", "perf", "ci", "build"]]
  }
}

version: "3.8"

services:
  app:
    build:
      context: .
      dockerfile: Dockerfile.dev
    ports:
      - "3000:3000"
    volumes:
      - .:/app
      - /app/node_modules
    environment:
      - NODE_ENV=development
    command: bun dev

version: "3.8"

services:
  app:
    build:
      context: .
      dockerfile: Dockerfile
    ports:
      - "3000:3000"
    environment:
      - NODE_ENV=production
    command: bun start

# Verify JSON syntax
cat avangclirc.json | jq .

# Check permissions
ls -la avangclirc.json

# Recreate file
rm avangclirc.json
avangcli config

# View precedence:
# 1. CLI args
# 2. avangclirc.json (project)

# Check project configuration
cat avangclirc.json