https://github.com/kamrul2006/k-visa
K-VISA is a Visa Navigator Portal to simplify the process of checking visa requirements, applying for visas online, and tracking applications. This project includes a dynamic user interface, robust functionality, and seamless user experience also.
https://github.com/kamrul2006/k-visa
firebase-auth npm-package react-router reactjs
Last synced: about 2 months ago
JSON representation
K-VISA is a Visa Navigator Portal to simplify the process of checking visa requirements, applying for visas online, and tracking applications. This project includes a dynamic user interface, robust functionality, and seamless user experience also.
- Host: GitHub
- URL: https://github.com/kamrul2006/k-visa
- Owner: kamrul2006
- Created: 2025-01-10T11:15:04.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-04T20:21:59.000Z (over 1 year ago)
- Last Synced: 2025-04-07T06:48:19.919Z (about 1 year ago)
- Topics: firebase-auth, npm-package, react-router, reactjs
- Language: JavaScript
- Homepage: https://k-visa-portal.web.app/
- Size: 5.76 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🌍 K-VISA: Visa Navigator Portal
## 🚀 Overview
**K-VISA** is a comprehensive Visa Navigator Portal designed to simplify the process of checking visa requirements, applying for visas online, and tracking applications. It provides a **dynamic user interface**, **robust functionality**, and a **seamless user experience** to ensure smooth visa processing.
🔗 **Live Demo:** [K-VISA Portal](https://k-visa-portal.web.app/)
## 📌 Features
- 🌐 **Fully Responsive** – Works seamlessly on all devices.
- 🎨 **Unique Design** – A visually appealing and user-friendly interface.
- 📋 **Visa Availability** – Browse all available visas in K-VISA.
- 🔍 **Check Visa Requirements** – Quickly check the eligibility criteria for different visas.
- 📝 **Online Visa Applications** – Submit visa applications digitally.
- 🔄 **Application Tracking** – Track the status of submitted visa applications.
- ❌ **Cancel Applications** – Users can cancel their visa applications anytime.
## 📂 Table of Contents
- [Installation](#installation)
- [Usage](#usage)
- [Environment Variables](#environment-variables)
- [Dependencies](#dependencies)
- [Development](#development)
- [License](#license)
-------------------------------
## 🛠 Installation
1. **Clone the repository**
```sh
git clone https://github.com/your-repo/k-visa.git
cd k-visa
```
2. **Install dependencies**
```sh
npm install
```
3. **Set up the environment variables**
Create a `.env` file in the root directory (see the next section for required variables).
4. **Start the development server**
```sh
npm run dev
```
## 🔧 Environment Variables
Create a `.env` file in the root directory with the following variables (replace with actual values):
```plaintext
FIREBASE_API_KEY=your_firebase_api_key
FIREBASE_AUTH_DOMAIN=your_firebase_auth_domain
FIREBASE_PROJECT_ID=your_firebase_project_id
FIREBASE_STORAGE_BUCKET=your_firebase_storage_bucket
FIREBASE_MESSAGING_SENDER_ID=your_firebase_messaging_sender_id
FIREBASE_APP_ID=your_firebase_app_id
```
⚠ **Note:** Never expose API keys or sensitive credentials in public repositories. Use `.gitignore` to exclude the `.env` file.
## 📦 Dependencies
This project uses the following libraries and frameworks:
### Frontend
- **React** (^18.3.1)
- **React Router DOM** (^7.0.2)
- **Lottie React** (^2.4.0)
- **React Icons** (^5.4.0)
- **React Toastify** (^10.0.6)
- **SweetAlert2** (^11.14.5)
### Development Tools
- **Vite** (^6.0.1)
- **TailwindCSS** (^3.4.15)
- **DaisyUI** (^4.12.14)
- **ESLint** (^9.15.0)
## ▶ Usage
- **Start Development Server**
```sh
npm run dev
```
- **Build for Production**
```sh
npm run build
```
- **Lint the Code**
```sh
npm run lint
```
- **Preview the Production Build**
```sh
npm run preview
```
## 🛠 Development
To contribute to this project:
1. **Fork the repository**
2. **Create a new branch** (`git checkout -b feature-branch`)
3. **Make changes and commit** (`git commit -m "Added new feature"`)
4. **Push to the branch** (`git push origin feature-branch`)
5. **Open a Pull Request**
## 📜 License
This project is licensed under the **MIT License**.
---
✨ **Enjoy Building with K-VISA!** 🚀
```
---
This README provides a **clear structure**, includes **important details**, and follows best practices for open-source projects. Let me know if you need any changes! 🚀