refactor: more conventional env file namings

.local for files that is ignored

Author: NamesMT

.gitignore

@@ -39,7 +39,8 @@ yarn-error.log*
 .pnpm-debug.log*
 
 # local env files
-.env.*.ignored
+.env.local
+.env.*.local
 
 # turbo
 .turbo

INIT_PROMPT.md

@@ -43,7 +43,7 @@ Welcome! Use this template to configure your new project based on the `starter-m
    3. **SST removal (optional):** If `REMOVE_SST` is true, SST files, scripts, dependencies, and references will be removed.
      <!-- + Context for Agent: when doing SST Removal, these are SST's files: (`sst.config.ts`, `.env.sst`), also remove the `pathe` and `@types/aws-lambda` dependency, they are only used by SST -->
    4. **Project context update & renaming:** The agent will update all related documents like `README.md` and Memory Bank with your (revised) goals and descriptions, as well as replace `starter-monorepo` with `MONOREPO_ROOT_NAME` throughout project/Memory Bank.
-   5. **Initialize local secret env files:** Scan the project for `.env.local` files and duplicate them as `.env.local.ignored` for each that exists.
+   5. **Initialize local secret env files:** Scan the project for `.env.dev` files and duplicate them as `.env.dev.local` for each that exists.
 3. **Finalizing steps**:
   <!-- + Context for Agent: ONLY START THIS STEP IF PRIOR STEPS IS DONE -->
    1. **INIT_PROMPT cleanup:** `INIT_PROMPT.md` and its related files (`INIT_PROMPT-EXAMPLES.md`) will be removed.

README.md

@@ -99,8 +99,8 @@ To build all apps and packages, run the following command:
 To develop all apps and packages, run the following command:  
 `pnpm run dev`
 
-To define local development environment variables of each app, either use `git update-index --skip-worktree .env.local` and use it directly, or create a copy of or rename `.env.local` to `.env.local.ignored`.
-  - AI Agent will help you creating the `.env.local.ignored` files if you use the AI initialization prompt.
+For local development environment variables / secrets, create a copy of `.env.dev` to `.env.dev.local`.
+  - AI Agent will help you creating the `.env.dev.local` files if you use the AI initialization prompt.
 
 ### Deploy
 

apps/backend-convex/.env.dev

@@ -0,0 +1,4 @@
+# Deployment used by `npx convex dev`
+CONVEX_DEPLOYMENT=dev:dazzling-panther-382 # team: namesmt, project: starter-monorepo
+
+CONVEX_URL=https://dazzling-panther-382.convex.cloud

apps/backend-convex/.gitignore

@@ -12,10 +12,10 @@
     "test:types": "tsc --noEmit --skipLibCheck",
     "quickcheck": "pnpm run lint && pnpm run test:types",
     "check": "pnpm lint && pnpm test:types && vitest run --coverage",
-    "dev": "dotenvx run -f .env.local.ignored -f .env.local -f .env -- tsx watch src/dev.ts",
+    "dev": "dotenvx run -f .env.dev.local -f .env.dev -f .env -- tsx watch src/dev.ts",
     "stub": "unbuild --stub",
-    "build": "dotenvx run -f .env.prod.ignored -f .env.prod -f .env -- unbuild",
-    "deploy": "dotenvx run -f .env.prod.ignored -f .env.prod -f .env -- sh scripts/deploy.sh"
+    "build": "dotenvx run -f .env.prod.local -f .env.prod -f .env -- unbuild",
+    "deploy": "dotenvx run -f .env.prod.local -f .env.prod -f .env -- sh scripts/deploy.sh"
   },
   "dependencies": {
     "srvx": "^0.8.0"

apps/backend/.env.local apps/backend/.env.devapps/backend/.env.local renamed to apps/backend/.env.dev

@@ -1,7 +1,7 @@
 # You can refer to /turbo.json for the explanation of the variables
 
 # For the frontend, please don't use the main `.env` file,
-# Instead, use `.env.local` and `.env.prod`, etc...
+# Instead, use `.env.dev` and `.env.prod`, etc...
 # Reason: it's hard to do complex priority control when loading multiple envs file (We can't control the loading of `.env`) and a weird resolve bug with `runtimeConfig` upon `generate`.
 
 # NUXT_PUBLIC_FRONTEND_URL=<YOUR_FRONTEND_URL>

apps/backend/package.json

@@ -5,11 +5,11 @@ import { config } from 'dotenv'
 import optimizeExclude from 'vite-plugin-optimize-exclude'
 
 if (import.meta.env.NODE_ENV === 'development') {
-  config({ path: ['.env.local.ignored', '.env.local'] })
+  config({ path: ['.env.dev.local', '.env.dev'] })
   import.meta.env.NUXT_PUBLIC_CONVEX_URL ||= (await getConvexEnvs()).CONVEX_URL || ''
 }
 else {
-  config({ path: ['.env.prod.ignored', '.env.prod'] })
+  config({ path: ['.env.prod.local', '.env.prod'] })
 }
 
 const siteConfig = {