🌐 Web-KA Portal

Live Project URL: https://web-ka-six.vercel.app/en

A comprehensive multilingual web portal featuring schemes, job listings, and an admin management dashboard.

---

📑 Table of Contents

• Features
• Tech Stack
• Getting Started
  • Prerequisites
  • Installation
• Project Structure
• Environment Variables
• License

---

🚀 Features

• 🌐 Multilingual Support: Fully localized routing and content using next-intl (supports English and other regional languages like Kannada).
• 📝 Schemes & Job Portal: Dedicated sections for exploring government/private schemes and job opportunities.
• 🛡️ Admin Dashboard: Secure administrative area for managing schemes, jobs, and platform content.
• 🔐 Authentication: Robust login and session management powered by next-auth.
• 🎨 Modern UI: Clean, responsive, and accessible interface built with Tailwind CSS and shadcn/ui.
• 🌙 Dark/Light Mode: Full theme customization via next-themes.
• 📧 Email Integrations: Sending automated notifications using Resend.
• SEO Optimized: Automated sitemap generation and optimal meta tags for better search engine indexing.

---

💻 Tech Stack

Frontend & Core

• Framework: Next.js 14 (App Router)
• Language: TypeScript
• Styling: Tailwind CSS
• UI Components: shadcn/ui, Radix UI
• Icons: Lucide React
• State Management: Zustand

Backend & Database

• Database: MongoDB (accessed via Mongoose)
• Auth: NextAuth.js
• API: Next.js App Router API Routes

Utilities

• Forms & Validation: React Hook Form + Zod
• i18n: next-intl
• Emails: Resend
• Markdown/Content: next-mdx-remote
• SEO: next-sitemap

---

🛠️ Getting Started

Prerequisites

• Node.js (v18 or higher)
• MongoDB Instance (Local or MongoDB Atlas)

Installation

1. Clone the repository:

   git clone <repository-url>
   cd web-ka

2. Install dependencies:

   npm install

3. Set up environment variables: Create a .env file in the root directory and add the required variables (see Environment Variables).

4. Seed the database (Optional): If you want to populate your database with initial data (schemes, jobs, etc.):

   npm run seed

5. Run the development server:

   npm run dev

6. Open http://localhost:3000 with your browser to see the result.

---

📁 Project Structure

web-ka/
├── app/                  # Next.js App Router (Pages, API routes, Layouts)
│   ├── [locale]/         # Internationalized pages
│   ├── admin/            # Admin dashboard routes
│   └── api/              # Backend API routes (e.g., /api/schemes)
├── components/           # Reusable UI components (shadcn/ui, job cards, etc.)
├── lib/                  # Utility functions, database connection, etc.
├── scripts/              # Seeding scripts for MongoDB
├── public/               # Static assets
└── package.json          # Project dependencies & scripts

---

🔑 Environment Variables

To run this project, you will need to add the following environment variables to your .env file:

# Database
MONGODB_URI=your_mongodb_connection_string

# NextAuth
NEXTAUTH_URL=http://localhost:3000
NEXTAUTH_SECRET=your_nextauth_secret_key

# Resend (Email Service)
RESEND_API_KEY=your_resend_api_key

# Other configurations (as required by the platform)

---

Built with ❤️ using Next.js