Agricultural Resource Optimization Platform

A comprehensive solution for optimizing agricultural resources through advanced data analytics, IoT integration, and machine learning, built with Next.js 15, Tailwind CSS, and TypeScript.

Features

Core Technologies

• ⚡ Next.js 15 - The latest version with App Router
• 🎨 Tailwind CSS - Utility-first CSS framework
• 📘 TypeScript - Type-safe code
• 🔒 Authentication - Clerk integration with persistent authorization toggle
• 🎭 Shadcn/ui - Beautiful and accessible components
• 💾 Convex DB - Real-time database with built-in file storage and serverless functions
• 💳 Polar.sh - Open-source solution for managing subscriptions and payments

Performance Optimizations

• 🚀 Route Prefetching - Instant page transitions for dashboard, Farm AI, and auth pages
• 🖼️ Optimized Images - Eager loading for critical images
• 🌓 Dark/Light Mode - System-aware theme switching with custom gradients
• 📱 Responsive Design - Mobile-first approach
• 🔄 Real-time Updates - Powered by Convex DB's real-time capabilities

Developer Experience

• 🧩 Component Library - Pre-built, customizable components
• 🎮 Farm AI - Built-in AI chat interface
• 📊 Dashboard Template - Ready-to-use admin interface with subscription management
• 🔍 SEO Optimized - Meta tags and sitemap generation

Convex DB Integration

To set up your Convex database, visit: [https://convex.dev/referral/SAMRAN3832]

Quick Start

1. Clone the repository:

git clone

2. Install dependencies:

bun install

3. Set up environment variables:

Create a .env.local file in the project root with the following content (replace values as needed):

NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=your_clerk_publishable_key
CLERK_SECRET_KEY=your_clerk_secret_key

# Deployment used by `npx convex dev`
CONVEX_DEPLOYMENT=your_convex_deployment
NEXT_PUBLIC_CONVEX_URL=your_convex_url

POLAR_ACCESS_TOKEN=your_polar_access_token
OPENAI_API_KEY=your_openai_api_key
DEEPSEEK_API_KEY=your_deepseek_api_key
GOOGLE_GENERATIVE_AI_API_KEY=your_google_generative_ai_api_key
NEXT_PUBLIC_CLERK_SIGN_IN_URL=/sign-in
NEXT_PUBLIC_CLERK_SIGN_UP_URL=/sign-up
NEXT_PUBLIC_CLERK_AFTER_SIGN_IN_URL=/
NEXT_PUBLIC_CLERK_AFTER_SIGN_UP_URL=/

# Convex
NEXT_PUBLIC_CONVEX_URL=
CONVEX_DEPLOYMENT=
CONVEX_ADMIN_KEY=

# Polar.sh
POLAR_WEBHOOK_SECRET=

# Frontend
NEXT_PUBLIC_BASE_URL=http://localhost:3000

# Optional: AI Integration
OPENAI_API_KEY=

5. Run the development server:

bun run dev

Open http://localhost:3000 to see your application.

Project Structure

├── app/
│   ├── (auth)/         # Authentication routes
│   ├── (marketing)/    # Marketing pages
│   ├── api/           # API routes
│   ├── dashboard/     # Dashboard pages
│   └── playground/    # AI Playground
├── components/
│   ├── homepage/     # Landing page components
│   ├── shared/       # Shared UI components
│   └── wrapper/      # Layout wrappers and navigation
├── config/           # Configuration files
├── convex/          # Convex DB schema and functions
├── lib/             # Utility functions
├── public/          # Static assets
│   ├── images/      # Image assets
│   └── svg/         # SVG assets
└── styles/          # Global styles

Available Scripts

• bun run dev - Start development server
• bun run build - Build for production
• bun run start - Start production server
• bun run lint - Run ESLint
• bun run format - Format code with Prettier

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Support

If you find this template helpful, please give it a ⭐️ on GitHub!