Skip to content

Latest commit

ย 

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ›ก๏ธ Self-Defense Master

HTML5 CSS3 JavaScript Status

Self-Defense Master is a comprehensive personal safety guide built with HTML5, CSS3, and vanilla JavaScript.

This interactive guide covers essential self-defense principles, practical techniques, common attack scenarios, injury recovery protocols, and the psychology of self-defense. Designed for complete beginners, it provides actionable knowledge to help you stay safe in various situations.

The project requires no frameworks, no backend, no database, and no build tools. It runs directly in a modern web browser.


๐ŸŽฎ Live Demo

๐Ÿ”— Explore Self-Defense Master


โœจ Features

  • ๐Ÿ›ก๏ธ Comprehensive self-defense principles
  • ๐Ÿ‘€ Situational awareness training
  • ๐Ÿคœ Essential defense techniques with visual cards
  • ๐ŸŽฏ Interactive technique explanations
  • ๐Ÿšจ Emergency guide with vibration feedback
  • ๐Ÿ“ฑ Mobile-friendly responsive design
  • ๐ŸŽญ Multiple scenario-based learning
  • ๐Ÿ’š Interactive HP (Health) recovery simulation
  • ๐Ÿง  Mental game and psychology training
  • โšก Quick navigation with tab system
  • ๐Ÿ”„ Smooth animations and transitions
  • ๐Ÿ“Š Progress tracking with HP bar animation
  • ๐ŸŽจ Modern dark theme with gradient design
  • ๐Ÿ–ฑ๏ธ Touch-friendly interface
  • ๐Ÿ  Bottom navigation for easy access
  • โš ๏ธ Warning signs identification

๐Ÿ•น๏ธ How to Use

Navigation

The app is divided into 5 main sections:

Section Content
๐Ÿ  Basics Core principles, awareness tips, and prevention strategies
๐Ÿคœ Techniques Essential self-defense moves with interactive cards
โš ๏ธ Scenarios Common attack situations and how to respond
๐Ÿ’š Recovery First aid, injury assessment, and HP simulation
๐Ÿง  Mental Psychology, confidence building, and mental preparation

Quick Access

  • Top Navigation - Switch between sections using tabs at the top
  • Bottom Navigation - Quick access buttons fixed at bottom of screen
  • Emergency Button - Red button in hero section for immediate emergency guide

๐Ÿ›ก๏ธ Core Self-Defense Principles

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚         SELF-DEFENSE MASTER PRINCIPLES      โ”‚
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚                                             โ”‚
โ”‚  1. AWARENESS                               โ”‚
โ”‚     โ””โ”€โ”€ Know what's happening around you    โ”‚
โ”‚                                             โ”‚
โ”‚  2. DE-ESCALATION                           โ”‚
โ”‚     โ””โ”€โ”€ Use words to calm situations        โ”‚
โ”‚                                             โ”‚
โ”‚  3. BOUNDARIES                              โ”‚
โ”‚     โ””โ”€โ”€ Say "NO" or "STOP" firmly           โ”‚
โ”‚                                             โ”‚
โ”‚  4. ESCAPE                                  โ”‚
โ”‚     โ””โ”€โ”€ Your goal is to get away safely     โ”‚
โ”‚                                             โ”‚
โ”‚  5. LEGAL RIGHTS                            โ”‚
โ”‚     โ””โ”€โ”€ Know your self-defense laws         โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

๐ŸŽฏ Defense Techniques Covered

Basic Strikes

Technique Target Description
๐Ÿ‘Š Palm Strike Nose/Chin Strike with base of palm
๐Ÿฆต Groin Kick Groin Kick upward forcefully
๐Ÿ’ช Elbow Strike Face/Ribs Close-range strike
๐Ÿƒ Escape & Run N/A Create distance and flee

Vulnerable Targets

  • Eyes - Disorient with a poke
  • Nose - Causes tears and confusion
  • Throat - Disrupts breathing
  • Groin - Extremely sensitive area
  • Knees - Side kick to disable movement

๐Ÿ“ฑ Scenario-Based Learning

Scenario 1: Wrist Grab

Action: Twist arm toward attacker's thumb (weakest point)
        Strike with free hand
        Run to safety

Avoid: Don't pull straight back
       Don't freeze in panic

Scenario 2: Front Approach

Action: Create distance immediately
        Use firm voice: "STOP! BACK AWAY!"
        Target vulnerable areas if they continue
        Escape

Avoid: Don't turn your back
       Don't engage in conversation

Scenario 3: Being Followed

Action: Change direction or cross street
        Go to crowded, well-lit area
        Call someone and speak loudly
        Enter a store or public building

Avoid: Don't go home (they'll know where you live)
       Don't confront unless necessary

๐Ÿ’š HP Recovery System

The app includes an interactive HP (Health) recovery simulation:

// HP Status Animation
Initial State: 30% (Low HP - Visual Warning)
After Recovery: 85% (Recovering)

Recovery Steps

  1. Assess Injuries - Check for bleeding, broken bones, head trauma
  2. Call for Help - Dial emergency services
  3. Get to Safety - Move to secure location
  4. Control Bleeding - Apply direct pressure with clean cloth
  5. Reduce Swelling - Apply ice packs for 15-20 minutes
  6. See a Doctor - Professional medical evaluation
  7. Mental Recovery - Talk to someone you trust

Warning Signs Requiring Immediate Medical Attention

  • โŒ Difficulty breathing
  • โŒ Severe bleeding that won't stop
  • โŒ Loss of consciousness (even briefly)
  • โŒ Confusion, dizziness, or vision problems
  • โŒ Chest or abdominal pain

๐Ÿง  Mental Game Training

Key Mental Skills

๐ŸŽฏ Stay Calm Under Pressure
   โ””โ”€โ”€ Practice deep breathing daily

๐ŸŽฏ Visualize Success
   โ””โ”€โ”€ Mentally rehearse defense scenarios

๐ŸŽฏ Develop a "Fighter's Stance"
   โ””โ”€โ”€ Stand with confidence, make eye contact

๐ŸŽฏ Learn From Close Calls
   โ””โ”€โ”€ Analyze and improve

๐ŸŽฏ Trust Your Instincts
   โ””โ”€โ”€ Your subconscious detects danger early

Daily Confidence Building Habits

  • โœ… Walk with purpose and awareness
  • โœ… Practice saying "NO" firmly in the mirror
  • โœ… Take a self-defense class (even online)
  • โœ… Share safety tips with friends and family
  • โœ… Regularly check your environment

๐Ÿ’ป Technologies Used

HTML5

  • Semantic structure
  • Tab navigation system
  • Interactive cards
  • Responsive layout

CSS3

  • Dark cosmic theme with gradients
  • Glowing effects and animations
  • Responsive grid system
  • Card hover effects
  • HP bar animations
  • Mobile-first design

JavaScript ES6

  • Tab switching functionality
  • HP bar animation
  • Interactive technique cards
  • Emergency button with vibration
  • Touch event handling
  • Smooth transitions

๐Ÿ“‚ Project Structure

Self_Defence_Master/
โ”‚
โ”œโ”€โ”€ index.html      # Complete Self-Defense Master app
โ””โ”€โ”€ README.md       # Project documentation

The entire application is contained in a single HTML file with embedded CSS and JavaScript.


๐Ÿš€ Run Locally

  1. Clone the repository:
git clone https://github.com/dhruvpandit46/Self_Defence_Master.git
  1. Navigate into the project:
cd Self_Defence_Master
  1. Open index.html in a modern web browser.

No dependencies. No build process. No server required.

You can also use VS Code Live Server for development.


๐ŸŒ Browser Compatibility

Self-Defense Master uses standard modern browser APIs.

Recommended Browsers:

  • โœ… Google Chrome
  • โœ… Microsoft Edge
  • โœ… Mozilla Firefox
  • โœ… Safari
  • โœ… Mobile browsers

๐ŸŽจ Visual Design

Theme

  • ๐ŸŒ‘ Dark Background - Cosmic gradient ( #1a1a2e to #16213e )
  • ๐Ÿ”ด Primary Colors - Red (#e74c3c) for emergencies
  • ๐Ÿ”ต Accent Colors - Blue (#3498db) for information
  • ๐Ÿ’š Success Colors - Green (#2ecc71) for recovery
  • โš ๏ธ Warning Colors - Yellow (#f39c12) for scenarios
  • โœจ Glassmorphism - Frosted glass effects
  • ๐ŸŽญ Gradient Text - Animated logo with gradient
  • ๐Ÿ“ฑ Mobile-Friendly - Fully responsive design

๐Ÿ”ง Core Functions

tab-switching

Handles navigation between sections with smooth transitions.

animateHPBar()

Simulates HP recovery with visual bar animation.

emergencyButton

Shows emergency guide with vibration feedback.

techniqueCard

Interactive cards that show technique details on click.


๐Ÿ“ˆ Feature Matrix

Feature Status
Self-Defense Principles โœ… Complete
Situational Awareness โœ… Complete
Defense Techniques โœ… Complete
Scenario Learning โœ… Complete
HP Recovery System โœ… Complete
Mental Game Training โœ… Complete
Emergency Guide โœ… Complete
Mobile Responsive โœ… Complete
Interactive Cards โœ… Complete
Animations โœ… Complete
Touch Support โœ… Complete
Bottom Navigation โœ… Complete

๐Ÿ”’ Privacy

The game runs entirely inside the browser.

It does not require:

  • User accounts
  • Backend server
  • Database
  • Cloud storage
  • External APIs
  • User tracking

No data is stored or transmitted anywhere.


๐Ÿšง Future Improvements

Possible future enhancements:

  • ๐Ÿ“น Video demonstrations of techniques
  • ๐ŸŽฎ Interactive self-defense quiz
  • ๐Ÿ“ Location-based safety tips
  • ๐Ÿ”” Daily safety reminders
  • ๐Ÿ“Š Progress tracking system
  • ๐Ÿ† Achievement badges
  • ๐Ÿ”Š Audio guides
  • ๐ŸŒ Multiple language support
  • ๐Ÿ“ฑ Offline mode (PWA)
  • ๐ŸŽฏ Real-time risk assessment
  • ๐Ÿ‘ฅ Community safety tips sharing
  • ๐Ÿ“… Self-defense training schedule
  • ๐Ÿ’ก Scenario-based simulations
  • ๐Ÿงช Self-defense technique rating system

๐Ÿค Contributing

Contributions and improvements are welcome!

  1. Fork the repository
  2. Create a feature branch:
git checkout -b feature/your-feature
  1. Make your changes
  2. Test locally
  3. Commit your changes:
git commit -m "Add your feature"
  1. Push to your branch:
git push origin feature/your-feature
  1. Open a Pull Request

๐Ÿ“œ License

This project is licensed under the MIT License.

MIT ยฉ 2026 Dhruv Pandit

See the LICENSE file for full license details.


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

Dhruv Pandit


โญ Support

If you found Self-Defense Master useful, consider giving the repository a โญ on GitHub!

It helps support development and motivates the creation of more helpful projects.


๐Ÿ™ Acknowledgments

  • Font Awesome for icons
  • The self-defense community for real-world insights
  • Everyone who prioritizes personal safety

Stay safe, stay aware, stay confident! ๐Ÿ›ก๏ธ

About

Your ultimate self-defense guide - learn essential protection techniques, situational awareness, and recovery strategies. Stay safe with this comprehensive personal safety companion!

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages