diff --git a/templates/onchainkit-nextjs/.template.env b/templates/onchainkit-nextjs/.template.env
index 56c8b23ebb..7e7fd73bda 100644
--- a/templates/onchainkit-nextjs/.template.env
+++ b/templates/onchainkit-nextjs/.template.env
@@ -1,2 +1,24 @@
-NEXT_PUBLIC_PROJECT_NAME="template-next-basic"
+# ─────────────────────────────────────────────────────────────────
+# OnchainKit Next.js Template — Environment Configuration
+# Copy this file to .env.local and fill in your values:
+#   cp .template.env .env.local
+# ─────────────────────────────────────────────────────────────────
+
+# Your project name (used for display purposes)
+NEXT_PUBLIC_PROJECT_NAME="my-onchainkit-app"
+
+# OnchainKit API key — get yours free at https://portal.cdp.coinbase.com
 NEXT_PUBLIC_ONCHAINKIT_API_KEY=""
+
+# ─────────────────────────────────────────────────────────────────
+# Network / RPC Configuration (optional)
+# ─────────────────────────────────────────────────────────────────
+
+# Base Sepolia (testnet) — public endpoint, no key required:
+# NEXT_PUBLIC_RPC_URL="https://sepolia.base.org"
+
+# Base Mainnet — public endpoint, no key required:
+# NEXT_PUBLIC_RPC_URL="https://mainnet.base.org"
+
+# For production use a dedicated RPC from Coinbase Developer Platform,
+# Alchemy, or QuickNode for better reliability and higher rate limits.