From 4c2154b62e7c3a06614f08a64ff4c0e0e66f0fd0 Mon Sep 17 00:00:00 2001
From: Faisal Nugroho <faisalnugroho@users.noreply.github.com>
Date: Thu, 28 May 2026 11:35:09 +0800
Subject: [PATCH] feat: improve template environment configuration for Base
 Sepolia development

- Add descriptive comments explaining each environment variable
- Include OnchainKit API key setup instructions with link
- Add Base Sepolia/Mainnet RPC endpoint reference
- Add optional WalletConnect and Coinbase Commerce config
- Improve developer onboarding experience for Base development

Closes #2644
---
 templates/minikit-nextjs/.template.env    | 18 ++++++++--
 templates/onchainkit-nextjs/.template.env | 44 +++++++++++++++++++++--
 2 files changed, 58 insertions(+), 4 deletions(-)

diff --git a/templates/minikit-nextjs/.template.env b/templates/minikit-nextjs/.template.env
index 245c1856b1..2ee7025b85 100644
--- a/templates/minikit-nextjs/.template.env
+++ b/templates/minikit-nextjs/.template.env
@@ -1,3 +1,17 @@
-NEXT_PUBLIC_PROJECT_NAME="template-next-basic"
-NEXT_PUBLIC_ONCHAINKIT_API_KEY=""
+# =============================================================================
+# MiniKit Template Environment Configuration
+# =============================================================================
+# Copy this file to .env.local and fill in your values:
+#   cp .template.env .env.local
+#
+# MiniKit enables Farcaster Mini App integration on Base.
+# =============================================================================
+
+# Project name displayed in the app
+NEXT_PUBLIC_PROJECT_NAME="My MiniKit App"
+
+# OnchainKit API key - Required for Swap, Fund, and other API features
+# Get yours at: https://onchainkit.xyz
+NEXT_PUBLIC_ONCHAINKIT_API_KEY=*** App URL - Required for Farcaster Mini App manifest
+# This should be your deployed app URL (e.g., https://myapp.vercel.app)
 NEXT_PUBLIC_URL=""
diff --git a/templates/onchainkit-nextjs/.template.env b/templates/onchainkit-nextjs/.template.env
index 56c8b23ebb..88d00fa006 100644
--- a/templates/onchainkit-nextjs/.template.env
+++ b/templates/onchainkit-nextjs/.template.env
@@ -1,2 +1,42 @@
-NEXT_PUBLIC_PROJECT_NAME="template-next-basic"
-NEXT_PUBLIC_ONCHAINKIT_API_KEY=""
+# =============================================================================
+# OnchainKit Template Environment Configuration
+# =============================================================================
+# Copy this file to .env.local and fill in your values:
+#   cp .template.env .env.local
+#
+# For Base Sepolia testnet development:
+#   1. Get an OnchainKit API key at https://onchainkit.xyz
+#   2. Set up a Coinbase Developer Platform (CDP) API key at https://portal.cdp.coinbase.com
+# =============================================================================
+
+# Project name displayed in the app
+NEXT_PUBLIC_PROJECT_NAME="My Base App"
+
+# OnchainKit API key - Required for Swap, Fund, and other API features
+# Get yours at: https://onchainkit.xyz
+NEXT_PUBLIC_ONCHAINKIT_API_KEY=
+
+# =============================================================================
+# OPTIONAL: Network Configuration
+# =============================================================================
+# Base Sepolia testnet is used by default for development.
+# For production, ensure your contracts are deployed to Base mainnet (chain ID 8453).
+#
+# Base Sepolia RPC (default, no key needed):
+#   https://sepolia.base.org
+# Base Mainnet RPC:
+#   https://mainnet.base.org
+# =============================================================================
+
+# =============================================================================
+# OPTIONAL: WalletConnect Project ID
+# Required if you want WalletConnect QR code support
+# Get yours at: https://cloud.walletconnect.com
+# =============================================================================
+# NEXT_PUBLIC_WALLET_CONNECT_PROJECT_ID=
+
+# =============================================================================
+# OPTIONAL: Coinbase Commerce
+# For accepting crypto payments in your app
+# =============================================================================
+# NEXT_PUBLIC_COINBASE_COMMERCE_APP_ID=