How to set up
How to build your directory website with Mkdirs template
Mkdirs requires several environment variables to function properly, and this guide explains how to set them up.
Create a .env file in the root directory of your project, and never commit it to version control.
You can copy the example file as a starting point:
Environment Variables
Core Configuration
| Variable | Description |
|---|---|
| NEXT_PUBLIC_APP_URL | "http://localhost:3000" or "https://mkdirs.com" |
Database & Storage
Learn how to set up a database in the Sanity Setup guide.
| Variable | Description |
|---|---|
| NEXT_PUBLIC_SANITY_PROJECT_ID | Sanity project ID |
| NEXT_PUBLIC_SANITY_DATASET | Sanity dataset name |
| SANITY_API_TOKEN | Sanity API token |
Authentication
Learn how to set up authentication in the Authentication Setup guide.
| Variable | Description |
|---|---|
| AUTH_SECRET | Secret for NextAuth authentication |
| AUTH_GOOGLE_ID | Google OAuth client ID |
| AUTH_GOOGLE_SECRET | Google OAuth client secret |
| AUTH_GITHUB_ID | GitHub OAuth client ID |
| AUTH_GITHUB_SECRET | GitHub OAuth client secret |
Email & Newsletter
Learn how to set up email in the Resend Setup guide.
| Variable | Description |
|---|---|
| RESEND_API_KEY | API key for Resend email service |
| RESEND_AUDIENCE_ID | Audience ID for Resend broadcast service |
| RESEND_EMAIL_FROM | Sender email address |
| RESEND_EMAIL_ADMIN | Admin email address |
Payment
Learn how to set up payments in the Stripe Setup guide.
| Variable | Description |
|---|---|
| STRIPE_API_KEY | Stripe API key |
| STRIPE_WEBHOOK_SECRET | Stripe webhook signing secret |
| NEXT_PUBLIC_STRIPE_PRO_PRICE_ID | Stripe price ID for paid submission |
Analytics
Learn how to set up analytics in the Analytics Setup guide.
| Variable | Description |
|---|---|
| NEXT_PUBLIC_GOOGLE_ANALYTICS_ID | Google Analytics ID |
| NEXT_PUBLIC_OPENPANEL_CLIENT_ID | OpenPanel Analytics client ID |
| NEXT_PUBLIC_UMAMI_WEBSITE_ID | Umami website ID |
| NEXT_PUBLIC_UMAMI_SCRIPT | Umami script URL |
| NEXT_PUBLIC_PLAUSIBLE_DOMAIN | Plausible domain |
| NEXT_PUBLIC_PLAUSIBLE_SCRIPT | Plausible script URL |
AI Features
Learn how to set up AI features in the AI Setup guide.
| Variable | Description |
|---|---|
| DEFAULT_AI_PROVIDER | Default AI provider for AI features: google, deepseek, openai |
| GOOGLE_GENERATIVE_AI_API_KEY | Google Generative AI API key for AI features |
| OPENAI_API_KEY | OpenAI API key for AI features |
| DEEPSEEK_API_KEY | DeepSeek API key for AI features |
Verifying Environment Variables
To verify that your environment variables are correctly set up, run:
If everything is configured correctly, your application should start and run normally without any environment-related errors.
Next Steps
Now that your environment is set up, explore these related topics:
Author
Categories
More Posts
Newsletter
Join the community
Subscribe to our newsletter for the latest news and updates