Skip to content

mookwoo/DynamicPasswordGenerator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

33 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

SecurePass - Dynamic Password Generator

A modern, feature-rich password generator with mood-based generation, theme support, and secure password management. This application creates secure, customizable passwords using advanced algorithms and provides a beautiful, responsive interface.

🌟 Features

Password Generation

  • Mood-based Generation: Choose from Happy, Fierce, Calm, Dark, or Creative moods
  • Theme Support: Fantasy, Sci-Fi, Professional, Nature, and Random themes
  • Customizable Length: 8-64 characters with visual slider
  • Character Types: Include/exclude numbers, symbols, uppercase, and lowercase
  • API Integration: Uses Datamuse API with local fallbacks for reliability
  • Smart Word Combinations: Combines adjectives and nouns contextually

User Interface

  • Modern Design: Clean, professional interface with CSS Grid/Flexbox
  • Dark/Light Mode: Toggle between themes with smooth transitions
  • Responsive Design: Works perfectly on desktop, tablet, and mobile
  • Accessibility: Full keyboard navigation and screen reader support
  • Visual Feedback: Password strength indicator and generation alerts

Password Management

  • History Tracking: Keep track of recently generated passwords
  • Save Functionality: Store passwords with titles and metadata (demo mode)
  • Search & Filter: Find saved passwords quickly
  • Export Options: Copy passwords to clipboard with one click
  • Mood Context: View generation settings for each password

Security Features

  • Client-side Generation: Passwords generated locally for privacy
  • No Server Dependencies: Works completely offline after initial load
  • Secure Storage: Uses browser localStorage for demo functionality
  • Input Validation: Comprehensive client-side validation

πŸš€ Live Demo

GitHub Pages: https://mookwoo.github.io/DynamicPasswordGenerator

πŸ›  Technologies Used

  • Frontend: HTML5, CSS3, Vanilla JavaScript (ES6+)
  • Styling: CSS Custom Properties, CSS Grid, Flexbox
  • Icons: Feather Icons
  • Fonts: Inter (UI), JetBrains Mono (passwords)
  • API: Datamuse API for word generation
  • Backend (optional): Node.js, Express, SQLite, JWT authentication

πŸ“± Usage

Quick Start

  1. Visit the live demo
  2. Choose your preferred mood and theme
  3. Adjust password length and character types
  4. Click "Generate Password"
  5. Copy or save your secure password

Demo Authentication

  • Login: Enter any email and password to access demo mode
  • Registration: Create a demo account with any credentials
  • Features: Full password management in localStorage (demo only)

Password Generation Tips

  • Happy mood: Generates cheerful words with bright themes
  • Fierce mood: Creates strong, powerful combinations
  • Calm mood: Produces peaceful, serene passwords
  • Dark mood: Uses mysterious, gothic elements
  • Creative mood: Combines artistic and imaginative words

πŸ”§ Local Development

Frontend Only (GitHub Pages Version)

# Clone the repository
git clone https://github.com/mookwoo/DynamicPasswordGenerator.git
cd DynamicPasswordGenerator

# Open in browser
open index.html
# or serve with a local server
python -m http.server 8000
# or
npx serve .

Full Stack Development

# Install dependencies
npm install

# Initialize database
npm run init-db

# Start development server
npm run dev

# Open http://localhost:3000

πŸ“ Project Structure

DynamicPasswordGenerator/
β”œβ”€β”€ index.html              # Main application page
β”œβ”€β”€ styles.css              # Modern CSS with themes
β”œβ”€β”€ script.js               # Frontend application logic
β”œβ”€β”€ package.json            # Node.js dependencies
β”œβ”€β”€ server.js               # Express server (optional)
β”œβ”€β”€ database/
β”‚   └── init.js            # Database initialization
β”œβ”€β”€ .env                    # Environment variables
└── README.md              # This file

πŸ” Security Notes

  • Passwords are generated client-side for maximum privacy
  • No passwords are transmitted over the network during generation
  • Demo mode uses localStorage - not suitable for production use
  • For production use, implement the full backend with proper encryption

🌍 Browser Support

  • Chrome: 90+
  • Firefox: 88+
  • Safari: 14+
  • Edge: 90+

πŸ“„ License

This project is open-source and available under the MIT License.

🀝 Contributing

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

πŸ“ž Support

For support, issues, or feature requests, please open an issue on GitHub.

πŸ”„ Version History & Release Notes

Current Release: v2.2.0 πŸŽ‰

Released August 21, 2025

🎯 Major Milestone: Complete GitHub Pages deployment with demo functionality

πŸ“Š Version Jump Explanation (v1.0 β†’ v2.2.0): We skipped intermediate versions to reflect the massive architectural changes and feature additions:

  • v2.0.0: Complete UI/UX overhaul with mood-based generation
  • v2.1.0: Enhanced theming and responsive design improvements
  • v2.2.0: GitHub Pages deployment with frontend-only architecture

This represents 18 months of development compressed into a single major release cycle, warranting the significant version jump to properly reflect the scope of changes.

✨ What's New:

  • Frontend-Only Operation: Full app functionality using localStorage
  • Demo Authentication: Simulated login/registration for GitHub Pages
  • Enhanced Password Management: Save, delete, and manage passwords locally
  • Mood Context Tracking: Password history shows generation settings
  • User Statistics: Track saved passwords and daily generation counts
  • Professional Documentation: Comprehensive feature overview and roadmap

πŸ”§ Technical Improvements:

  • Modified authentication for client-side operation
  • Enhanced responsive design for all devices
  • Improved mood-based password generation accuracy
  • Updated project structure for static hosting

Previous Releases:

  • v2.1.0: Enhanced themes and responsive design improvements
  • v2.0.0: Major UI overhaul with mood-based generation and modern design
  • v1.0.0: Initial release with basic password generation

πŸ—ΊοΈ Roadmap

For detailed upcoming features and development plans, see our comprehensive roadmap below.

Upcoming highlights:

  • Password Templates & Presets (v2.3.0)
  • Bulk Password Generation (v2.3.0)
  • Advanced Security Metrics (v2.5.0)
  • Progressive Web App (v3.1.0)

Complete Feature Roadmap

πŸš€ Immediate High-Impact Features (v2.3.0)

  1. Password Templates & Presets - Quick preset buttons for gaming, work, banking, social media
  2. Bulk Password Generation - Generate 5-50 passwords with export capabilities
  3. Password Analysis Dashboard - Comprehensive analytics and usage insights

🎨 Enhanced User Experience (v2.4.0)

  1. Visual Password Customization - Real-time preview with character highlighting
  2. Smart Suggestions Engine - AI-like suggestions based on user patterns
  3. Import/Export System - Backup/restore with password manager compatibility

πŸ” Advanced Security Features (v2.5.0)

  1. Advanced Security Metrics - Entropy calculation, crack time estimation, breach checking
  2. Pronounceable Password Generator - Human-friendly phonetic passwords
  3. Password Expiration & Health Tracking - Lifecycle management with reminders

🌟 Fun & Engagement Features (v2.6.0)

  1. Achievement System - Gamification to encourage good password habits
  2. Daily Password Challenge - Themed challenges with streak tracking
  3. Password Art Generator - Creative visual representations of passwords

πŸ›  Power User Features (v3.0.0)

  1. Advanced Search & Filtering - Complex queries for large password collections
  2. Custom Word Lists & Dictionaries - Personalized vocabulary and language support
  3. API Integration Hub - Multiple word APIs with intelligent fallbacks

πŸ“± Modern Web Features (v3.1.0)

  1. Progressive Web App (PWA) - Offline functionality and app installation
  2. Keyboard Shortcuts & Accessibility - Power user efficiency features
  3. Voice Commands & Speech Integration - Hands-free operation

For complete technical details, implementation timelines, and contribution opportunities, see ROADMAP.md.


Made with ❀️ for secure password generation

About

The Dynamic Password Generator is a customizable web tool that creates unique passwords based on selected themes like Fantasy, Sci-Fi, and Professional. Leveraging the Datamuse API, it generates creative combinations of adjectives, nouns, and numbers, making it perfect for gaming, social media, and professional use.

Resources

License

Stars

Watchers

Forks

Contributors