Skip to content

CourageCodeJourney/hacktoberfest-code-galaxy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

38 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŒŒ Hacktoberfest Code Galaxy

Hacktoberfest Code Galaxy is an interactive CSS and JavaScript art project inspired by the creativity of open-source. It visualizes a glowing galaxy of animated elements, celebrating the spirit of collaboration and code during Hacktoberfest ๐ŸŒ .


๐Ÿš€ Live Demo

View Live Demo


โœจ Features

Visual Elements

  • ๐ŸŒŸ 200+ Twinkling Stars - Different sizes with varied animation speeds, including a multi-layered shining stars effect.
  • โ˜„๏ธ Floating Asteroids - Randomly generated space debris drifting across the galaxy.
  • ๐ŸŒˆ Nebula Clouds - Colorful gas clouds with drift animations.
  • ๐Ÿ’ซ Code Comets - Shooting comets streaking across space.
  • ๐Ÿง‘โ€๐Ÿš€ Orbiting Astronaut - Slow-moving astronaut with gentle bobbing animation.
  • ๐Ÿ›ฐ๏ธ Satellite Orbiters - Mini satellites orbiting the main repository.
  • โœจ Stardust Particles - Subtle background particle effects.

Interactive Features

  • ๐ŸŽต Advanced Music System - Dual-mode music with procedural generation or custom files, includes volume control and persistent settings. NEW: Track Selector - Switch between 5+ music tracks on-the-fly! See MUSIC_GUIDE.md and MUSIC_TRACK_SELECTOR.md for details.
  • ๐ŸŽฏ Clickable PRs - Hover over pull requests to see their status.
  • ๐Ÿ“Š Animated Stats Counter - Live counting animation for repository statistics.
  • ๐Ÿ’ฅ Warp Speed Effect - Click the main repository for a warp jump animation.
  • ๐ŸŽ† Mini Galaxy Burst - Double-click anywhere to create particle explosions.
  • ๐ŸŒง๏ธ Code Rain - Click contributors to trigger falling code symbols.
  • ๐Ÿ’ฌ Enhanced Tooltips - Hover tooltips showing detailed PR information.
  • ๐Ÿ”„ Pulsing Rings - Ripple effects emanating from the center.

Technical Features

  • Fully responsive design for all screen sizes.
  • Pure HTML/CSS/JavaScript - no dependencies required.
  • Smooth 60 FPS animations.
  • Mobile-optimized with adaptive layouts.
  • Modular file structure for easy contribution.

๐Ÿ“ File Structure

hacktoberfest-code-galaxy/
โ”‚
โ”œโ”€โ”€ assets/               # Image and media files
โ”‚   โ”œโ”€โ”€ astronaut.png     # Astronaut sprite (fallback: emoji used)
โ”‚   โ”œโ”€โ”€ hacktoberfest.jpg   # Preview image
โ”‚   โ””โ”€โ”€ [additional images]   # Screenshots and assets
โ”‚
โ”œโ”€โ”€ css/
โ”‚   โ””โ”€โ”€ style.css         # Main stylesheet with animations
โ”‚
โ”œโ”€โ”€ js/
โ”‚   โ””โ”€โ”€ script.js         # Interactive JavaScript logic
โ”‚
โ”œโ”€โ”€ index.html            # Main HTML structure
โ”œโ”€โ”€ README.md             # Project documentation (this file)
โ”œโ”€โ”€ CONTRIBUTING.md       # Contribution guidelines
โ””โ”€โ”€ LICENSE               # MIT License

๐Ÿงฉ Tech Stack

  • HTML5 - Semantic structure
  • CSS3 - Advanced animations, gradients, and effects
  • Vanilla JavaScript - Dynamic element generation and interactions

๐Ÿ–ฅ๏ธ Running Locally

To run this project on your local machine:

# Clone the repository
git clone https://github.com/CourageCodeJourney/hacktoberfest-code-galaxy.git

# Navigate to the project directory
cd hacktoberfest-code-galaxy

# Open index.html in your browser
# You can use a simple HTTP server for best results:
python -m http.server 8000
# Then open http://localhost:8000 in your browser

No build process or dependencies required โ€” it's pure frontend code! ๐Ÿ’ป


๐ŸŽฏ Contributing

Contributions are highly encouraged โ€” this project is open for Hacktoberfest 2025!

๐ŸŒŸ Ideas for Contributions

Visual Enhancements

  • ๐ŸŽจ Add new color themes or a dark mode toggle
  • ๐ŸŒŒ Create constellation patterns connecting stars
  • ๐Ÿช Add planets or space stations
  • ๐ŸŒ  Implement parallax scrolling effects
  • ๐ŸŽญ Add custom contributor avatars

Interactive Features

  • ๐ŸŽฎ Create mini-games (asteroid dodging, etc.)
  • ๐Ÿ“ฑ Implement touch gesture controls for mobile
  • ๐Ÿ† Add an achievement system for interactions
  • ๐Ÿ’พ Save user preferences in localStorage

Code Quality

  • ๐Ÿ“ Add comprehensive code comments
  • ๐Ÿงช Write unit tests for JavaScript functions
  • โ™ฟ Improve accessibility (ARIA labels, keyboard navigation)
  • ๐Ÿš€ Optimize performance and animations
  • ๐Ÿ“š Create detailed JSDoc documentation

Documentation

  • ๐Ÿ“– Add tutorials for specific features
  • ๐ŸŽฅ Create a video walkthrough
  • ๐ŸŒ Translate README to other languages
  • ๐Ÿ“ธ Add more screenshots and GIFs

๐Ÿ“ How to Contribute

  1. Fork this repository
  2. Create a new branch for your feature
    git checkout -b feature/amazing-feature
  3. Make your changes and commit with descriptive messages
    git commit -m "Add: Shooting meteor shower animation"
  4. Push to your fork
    git push origin feature/amazing-feature
  5. Submit a Pull Request with a clear description of changes

Note: Please ensure your PR follows the existing code style and includes comments where necessary.


๐Ÿชฉ Hacktoberfest 2025

This project proudly participates in Hacktoberfest 2025 โ€” an annual celebration of open-source software.

๐Ÿ“… Important Dates

  • Event Duration: October 1โ€“31, 2025
  • Goal: Complete 4 quality pull requests to earn rewards

๐Ÿท๏ธ Valid Contributions

  • Bug fixes and feature additions
  • Documentation improvements
  • Code refactoring and optimization
  • UI/UX enhancements
  • Accessibility improvements

Make your contribution during October and join thousands of developers building the open web! ๐ŸŒ


๐Ÿ“ธ Preview & Demos

Here are some of the interactive features in action:

Shining Stars & Galaxy Background

Galaxy Music Toggle

๐ŸŽฌ Other Interactive Features

  • Warp Speed: Click the Main Repo center for a warp speed effect.
  • Particle Burst: Double-click anywhere for a particle burst.
  • PR Tooltips: Hover PRs to see status tooltips.
  • Code Rain: Click contributors for a code rain animation.

๐Ÿค Code of Conduct

Please note that this project follows the Contributor Covenant Code of Conduct. By participating, you are expected to uphold this code.


๐Ÿ“„ License

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

You're free to:

  • โœ… Use commercially
  • โœ… Modify and distribute
  • โœ… Use privately
  • โœ… Sublicense

Just give appropriate credit! ๐ŸŒŸ


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

Courage Paul (CourageCodeJourney)


๐Ÿ™ Acknowledgments

  • Inspired by the amazing open-source community
  • Special thanks to all Hacktoberfest participants
  • Built with passion for creative coding

๐Ÿ’ซ "Creativity begins when you turn logic into art." ๐ŸŒŒ

Star โญ this repository if you found it helpful!

Made with ๐Ÿ’– for the community

About

CSS + JS Art inspired by Hacktoberfest โ€” glowing code galaxy with interactive planets ๐ŸŒŒ

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 9