Skip to content

JitishxD/LevelUpSecurity

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

20 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ›ก๏ธ LevelUpSecurity

Stop "Tick-the-Box" Security Training.

Imagine a company giving the same car maintenance training to both a professional mechanic and a salesperson who just drives the car. The mechanic needs advanced technical details, while the salesperson just needs to know how to check the oil and tire pressure. Giving them the same generic course is a waste of time for both.

This is exactly what happens with most cybersecurity training. A person in marketing faces different online threats (like social media scams) than a system administrator (who deals with network attacks). Yet, they are both forced to sit through the same basic, generic training videos

LevelUpSecurity is a revolutionary cybersecurity education that solves this

๐Ÿš€ Live Demo

Website: https://jitishxd.github.io/LevelUpSecurity/

๐ŸŽฏ Why LevelUpSecurity?

Generic, one-size-fits-all cybersecurity training fails to engage employees and often leads to security fatigue. LevelUpSecurity revolutionizes cybersecurity education by providing:

  • ๐ŸŽญ Role-Specific Learning Paths: Tailored content for different job functions (Marketing, IT, HR, Finance, etc.)
  • ๐ŸŽฎ Gamified & Interactive Modules: Engaging simulations that make learning enjoyable
  • ๐ŸŽฏ Real-World Scenarios: Practical training based on actual threat scenarios
  • ๐Ÿ“Š Reduced Security Fatigue: Smart, relevant content that employees actually care about
  • ๐Ÿ› ๏ธ Proactive Defense: Transform employees from security weakness to security strength

โœจ Key Features

๐Ÿ” Authentication System

  • Secure user registration and login
  • JWT-based authentication with HTTP-only cookies
  • Protected routes for authenticated users
  • Session management with automatic logout

๐ŸŽ“ Personalized Learning

  • Role-based training modules
  • Adaptive learning paths based on user profiles
  • Progress tracking and completion certificates
  • Interactive assessments and quizzes

๐ŸŽฎ Engaging Content

  • Gamified learning experiences
  • Real-world phishing simulations
  • Interactive scenario-based training
  • Multi-media rich content

๐Ÿ“ฑ Modern User Experience

  • Responsive design for all devices
  • Clean, intuitive interface
  • Fast loading with Vite build optimization
  • Accessible and user-friendly navigation

๐Ÿ› ๏ธ Tech Stack

Frontend

  • React 19.1.1 - Modern UI framework
  • Vite 7.1.2 - Fast build tool and development server
  • Tailwind CSS 4.1.13 - Utility-first CSS framework
  • ESLint - Code linting and quality

Backend

  • Node.js - JavaScript runtime
  • Express.js 5.1.0 - Web application framework
  • MongoDB - NoSQL database
  • Mongoose 8.18.1 - MongoDB object modeling
  • JWT - JSON Web Tokens for authentication
  • bcryptjs - Password hashing
  • CORS - Cross-Origin Resource Sharing

Deployment & DevOps

  • GitHub Pages - Frontend hosting
  • Vercel - Backend deployment
  • Git - Version control
  • gh-pages - Automated deployment

๐Ÿ“ Project Structure

LevelUpSecurity/
โ”œโ”€โ”€ frontend/                   # React frontend application
โ”‚   โ”œโ”€โ”€ src/
โ”‚   โ”‚   โ”œโ”€โ”€ Components/         # React components
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ AuthPage.jsx   # Authentication forms
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ Home.jsx       # Dashboard/Home page
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ LearnMore.jsx  # Information pages
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ LevelUpSecurity.jsx  # Landing page
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ ProtectedRoute.jsx   # Route protection
โ”‚   โ”‚   โ”œโ”€โ”€ contexts/          # React contexts
โ”‚   โ”‚   โ”œโ”€โ”€ services/          # API service functions
โ”‚   โ”‚   โ”œโ”€โ”€ Utils/             # Utility functions
โ”‚   โ”‚   โ”œโ”€โ”€ assets/            # Static assets
โ”‚   โ”‚   โ””โ”€โ”€ App.jsx            # Main app component
โ”‚   โ”œโ”€โ”€ package.json           # Dependencies and scripts
โ”‚   โ””โ”€โ”€ vite.config.js         # Vite configuration
โ”‚
โ””โ”€โ”€ backend/                   # Node.js backend API
    โ”œโ”€โ”€ src/
    โ”‚   โ”œโ”€โ”€ middleware/        # Custom middleware
    โ”‚   โ”œโ”€โ”€ models/            # Database models
    โ”‚   โ”œโ”€โ”€ router/            # API routes
    โ”‚   โ”‚   โ”œโ”€โ”€ routes.js      # Route definitions
    โ”‚   โ”‚   โ””โ”€โ”€ authController.js  # Authentication logic
    โ”‚   โ”œโ”€โ”€ utils/             # Utility functions
    โ”‚   โ””โ”€โ”€ db.js              # Database connection
    โ”œโ”€โ”€ index.js               # Server entry point
    โ””โ”€โ”€ package.json           # Backend dependencies

๐Ÿš€ Getting Started

Prerequisites

  • Node.js (v16 or higher)
  • npm or yarn
  • MongoDB (local installation or cloud service like MongoDB Atlas)
  • Git

Installation

  1. Clone the repository

    git clone https://github.com/jitishxd/levelupsecurity.git
    cd levelupsecurity
  2. Set up the Backend

    cd backend
    npm install
    
    # Create environment file
    cp .env.example .env
    # Edit .env with your configuration:
    # MONGODB_URI=your_mongodb_connection_string
    # JWT_SECRET=your_jwt_secret
    # PORT=3000
  3. Set up the Frontend

    cd ../frontend
    npm install

Running the Application

  1. Start the Backend Server

    cd backend
    npm run dev

    Server will run on http://localhost:3000

  2. Start the Frontend Development Server

    cd frontend
    npm run dev

    Application will open at http://localhost:5173

Building for Production

Frontend Build:

cd frontend
npm run build

Deploy to GitHub Pages:

cd frontend
npm run deploy

๐Ÿ“š API Documentation

Authentication Endpoints

Method Endpoint Description
POST /api/v1/signup Register new user
POST /api/v1/login User login
POST /api/v1/logout User logout
GET /api/v1/getAuthStatus Check authentication status

Example API Usage

Sign Up:

POST /api/v1/signup
Content-Type: application/json

{
  "email": "user@example.com",
  "password": "securePassword123",
  "name": "Jitish",
}

Login:

POST /api/v1/login
Content-Type: application/json

{
  "email": "user@example.com", 
  "password": "securePassword123"
}

๐Ÿ”ง Configuration

Environment Variables

Create a .env file in the backend directory:

# Database
MONGODB_URI=mongodb://localhost:27017/levelupsecurity

# Authentication
JWT_SECRET=your-super-secure-jwt-secret-key

# Server
PORT=3000
NODE_ENV=production

# CORS
FRONTEND_URL=https://jitishxd.github.io

Frontend Configuration

Update vite.config.js for custom build settings:

export default {
  base: '/LevelUpSecurity/',
  build: {
    outDir: 'dist'
  }
}

๐Ÿ“„ License

This project is licensed under the ISC License - see the LICENSE file for details.

๐Ÿ‘จโ€๐Ÿ’ป Author

Jitish
Amrit Raj Rai
Om Dixit
Tanush

๐Ÿ“ˆ Roadmap

  • Advanced Analytics - Detailed learning progress tracking
  • Multi-language Support - Internationalization for global reach
  • Mobile App - Native mobile applications for iOS and Android
  • AI-Powered Recommendations - Machine learning-based personalized learning paths
  • Enterprise Features - Advanced admin dashboard and reporting tools

๐Ÿ”’ Building a More Secure Digital World, One Employee at a Time.


Made with โค๏ธ for cybersecurity education and awareness

Releases

No releases published

Packages

 
 
 

Contributors

Languages