diff --git a/templates/minikit-nextjs/.template.env b/templates/minikit-nextjs/.template.env
index 245c1856b1..b88a9435fc 100644
--- a/templates/minikit-nextjs/.template.env
+++ b/templates/minikit-nextjs/.template.env
@@ -1,3 +1,27 @@
-NEXT_PUBLIC_PROJECT_NAME="template-next-basic"
+# ==============================================================
+# OnchainKit MiniKit Next.js Template — Environment Configuration
+# ==============================================================
+# Copy this file to .env.local and fill in your values.
+# Never commit .env.local — it is already in .gitignore.
+# ==============================================================
+
+# Your project name — used as the <title> in layout.tsx.
+NEXT_PUBLIC_PROJECT_NAME="my-minikit-app"
+
+# OnchainKit API key — get yours free at https://portal.cdp.coinbase.com/
+# Required for OnchainKit components (wallet, identity, MiniKit, etc.).
 NEXT_PUBLIC_ONCHAINKIT_API_KEY=""
+
+# Canonical URL of your app (no trailing slash).
+# Used for MiniKit frame metadata and notification proxying.
+# In production this is set automatically via VERCEL_URL;
+# set it here for local development.
+#   Example: http://localhost:3000
 NEXT_PUBLIC_URL=""
+
+# --------------------------------------------------------------
+# Optional: WalletConnect Project ID
+# Required only if you add WalletConnect support via wagmi.
+# Create a project at https://cloud.walletconnect.com/
+# --------------------------------------------------------------
+# NEXT_PUBLIC_WC_PROJECT_ID=""
diff --git a/templates/onchainkit-nextjs/.template.env b/templates/onchainkit-nextjs/.template.env
index 56c8b23ebb..9d17680c01 100644
--- a/templates/onchainkit-nextjs/.template.env
+++ b/templates/onchainkit-nextjs/.template.env
@@ -1,2 +1,30 @@
-NEXT_PUBLIC_PROJECT_NAME="template-next-basic"
+# ==============================================================
+# OnchainKit Next.js Template — Environment Configuration
+# ==============================================================
+# Copy this file to .env.local and fill in your values.
+# Never commit .env.local — it is already in .gitignore.
+# ==============================================================
+
+# Your project name — used as the <title> in layout.tsx.
+NEXT_PUBLIC_PROJECT_NAME="my-onchain-app"
+
+# OnchainKit API key — get yours free at https://portal.cdp.coinbase.com/
+# Required for OnchainKit components (wallet, identity, swap, etc.).
 NEXT_PUBLIC_ONCHAINKIT_API_KEY=""
+
+# --------------------------------------------------------------
+# Optional: WalletConnect Project ID
+# Required only if you add WalletConnect support via wagmi.
+# Create a project at https://cloud.walletconnect.com/
+# --------------------------------------------------------------
+# NEXT_PUBLIC_WC_PROJECT_ID=""
+
+# --------------------------------------------------------------
+# Optional: Custom RPC URL
+# The template targets Base Mainnet by default (rootProvider.tsx).
+# To develop against Base Sepolia testnet, replace with:
+#   https://sepolia.base.org
+# Or use a private RPC from Alchemy / QuickNode / Infura for
+# higher rate limits in production.
+# --------------------------------------------------------------
+# NEXT_PUBLIC_RPC_URL="https://mainnet.base.org"