10000 GitHub - asfarsadewa/jempol: a particle based creature that follows your touch/cursor.
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

asfarsadewa/jempol

Repository files navigation

🔥 Jempol - Interactive Particle Creature

Jempol is an interactive web application that creates a mesmerizing particle-based creature that follows your touch/cursor. Built with Next.js 15, P5.js, and TypeScript, it demonstrates creative coding and fluid animation techniques.

✨ Features

  • Responsive Particle System: A dynamic particle system that creates a fluid, organic movement
  • Touch & Mouse Support: Fully responsive design that works on both mobile and desktop
  • Interactive Feeding: Feed the creature to trigger special behaviors and animations
  • Organic Movement: Natural-looking motion using steering behaviors and Perlin noise
  • Dynamic Colors: Beautiful color transitions during interactions

🚀 Getting Started

  1. Clone the repository:
git clone https://github.com/yourusername/jempol.git
cd jempol
  1. Install dependencies:
bun install
  1. Run the development server:
bun dev
  1. Open http://localhost:3000 with your browser to see the result.

🛠 Tech Stack

🎮 How to Use

  1. Basic Interaction: Move your cursor or touch the screen to guide the particle creature
  2. Feeding: Click the food button in the bottom right to trigger special behaviors
  3. Mobile: Best experienced on mobile devices with touch interaction

🎨 Customization

The particle system can be customized by modifying parameters in src/components/P5Canvas.tsx:

  • Particle count
  • Particle size
  • Movement speed
  • Colors
  • Physics behavior
  • Animation durations

📱 Mobile-First Design

Jempol is designed with mobile-first principles, ensuring a smooth and engaging experience on touch devices while maintaining full functionality on desktop browsers.

📄 License

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

🤝 Contributing

Contributions are welcome! Feel free to submit a Pull Request.

🙏 Acknowledgments

  • Inspired by particle systems and fluid dynamics
  • Built with modern web technologies
  • Created for interactive art exploration

Made with ❤️ by [Your Name]

About

a particle based creature that follows your touch/cursor.

Resources

Stars

Watchers

Forks

Releases

No releases published
0