Combatlas is a modern, interactive web application designed to serve as a comprehensive encyclopedia for the Indian Armed Forces. It provides real-time data on military assets, including equipment of the Indian Army, Navy ships, and Air Force aircraft. The platform features an advanced AI chatbot, "Atlas," to assist users with queries related to Indian defense history, strategy, and capabilities.
- Dynamic Data Engine: Automatically fetches and parses real-time data from Wikipedia, ensuring the information is always up-to-date without manual maintenance.
- Atlas AI Chatbot: A specialized military-AI assistant powered by Groq (Llama 3), capable of answering complex questions about Indian defense with context-aware responses.
- Secure Authentication: Custom login system with SHA-256 password hashing and persistent session management using local storage.
- Interactive Dashboard: A futuristic, sci-fi inspired UI with filtering capabilities to explore assets by branch (Army, Navy, Air Force).
- Responsive Design: Built with a mobile-first approach using Tailwind CSS for a seamless experience across devices.
- Frontend Framework: React (v18)
- Build Tool: Vite
- Language: TypeScript
- Styling: Tailwind CSS
- AI Integration: Groq API (Llama-3.3-70b-versatile)
- Icons: Lucide React
Follow these instructions to set up the project locally on your machine.
- Node.js (v16 or higher)
- npm (Node Package Manager)
-
Clone the repository (or extract the project folder):
git clone <repository-url> cd combatlas
-
Install dependencies:
npm install
-
Setup Environment Variables: Create a
.envfile in the root directory and add your Groq API key:VITE_GROQ_API_KEY=your_groq_api_key_here
-
Run the development server:
npm run dev
-
Open in Browser: Navigate to
http://localhost:5173to view the application.
- Credential Storage: User passwords are hashed using SHA-256 before being stored in the browser's Local Storage.
- Data Privacy: No personal data is sent to external servers other than the AI chat queries (which are processed by Groq).
Architected by: Aaditya Sadhu Organization: Global Defense Index (GDI)
Jai Hind 🇮🇳