Skip to content

Wafflez007/Unity-Spark

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Unity Spark (The Ripple Effect) ⚡

"Small ripples create big waves."

Unity Spark is a minimalist web app designed to bridge the gap between "wanting to connect" and "actually connecting." It removes social friction by generating immediate, micro-unity challenges that gamify kindness and human connection.

📖 About the Project

Inspiration

I live in a world that often feels divided and isolated. I noticed that many people want to connect or do good, but they get stuck in "analysis paralysis"—they don't know what to do, or they feel like their small actions won't matter. I also realized that most apps designed to solve this require complex sign-ups and long onboarding processes, which creates friction. I wanted to build the antidote: a zero-friction tool that turns the abstract concept of "Unity" into immediate, actionable steps.

What it does

Unity Spark is a "Micro-Unity Generator."

  • Instant Action: Users are presented with a simple, calming interface with one button: "Ignite a Spark."
  • The Challenge: When clicked, the app pulls from a curated database of over 50 human-connection challenges (e.g., "Text a friend you haven't seen in a month," "Compliment a stranger," "Forgive a small grievance").
  • Gamified Urgency: A 60-second visual timer begins immediately. This gamification forces the user to act now rather than putting it off for later.
  • Reward: Upon completion, the user is rewarded with a confetti celebration and a streak counter that saves to their local browser, encouraging daily habits of kindness.

How I built it

I built this entirely in Vanilla JavaScript, HTML5, and Tailwind CSS.

  • Architecture: To ensure maximum accessibility and ease of deployment, I avoided all backend complexity. The entire app lives in a single index.html file.
  • Styling: I used Tailwind CSS via CDN for rapid UI development, focusing on "Glassmorphism" design trends to make it feel modern and soothing.
  • Logic: I utilized localStorage to persist the user's "Spark Streak" without needing a database login. I used the canvas-confetti library for the celebration effects.

Challenges I ran into

  • Scope Creep: The biggest challenge was resisting the urge to add "just one more feature" (like user profiles or social feeds). I had to ruthlessly cut features to stick to the core philosophy of minimalism.
  • Writing Content: Coding the app was fast, but writing 50+ unique, meaningful, and safe challenges that anyone could do anywhere took significant thought.
  • Mobile Responsiveness: Ensuring the timer animation and glass-panels looked perfect on both desktop and mobile screens required some tricky CSS adjustments.

Accomplishments that I'm proud of

  • Efficient Execution: I successfully took the project from a concept to a fully polished, deployed application, focusing on clean code and immediate usability.
  • Zero Friction: I achieved my goal of an app that requires 0 clicks to get started.
  • Aesthetics: I am proud of the polished, professional look (animations, gradients, glass effects) achieved with very little code.

What I learned

I learned that simplicity is a feature. By removing the backend, login, and settings, I actually made the app more likely to be used. I also learned how powerful small, randomized prompts can be in changing a user's behavior.

What's next for The Ripple Effect

  • Social Sharing: Generating a sharable image of the challenge you just completed to challenge friends.
  • Global Counter: Implementing a lightweight backend (Firebase) to track the total number of "Sparks" ignited worldwide by all users.
  • Community Submissions: Allowing users to submit their own unity challenges to the database.

🚀 Getting Started

Since this project is built as a single-file application, running it is incredibly simple.

Prerequisites

  • A modern web browser (Chrome, Firefox, Safari, Edge).

That's it!

Installation

  1. Clone the repo:

    git clone https://github.com/yourusername/unity-spark.git
  2. Open index.html in your browser.

Deployment

This project is ready for immediate deployment on GitHub Pages, Vercel, or Netlify. Just upload the index.html file.

🛠️ Built With

  • HTML5 - Structure
  • Tailwind CSS - Styling (via CDN)
  • Vanilla JavaScript - Logic & State Management
  • Canvas Confetti - Celebration Effects
  • Font Awesome - Icons
  • Google Fonts - Typography (Outfit)

📄 License

Distributed under the MIT License. See LICENSE for more information.


Built with ❤️ for the Global Unity Hackathon 2025.

Releases

No releases published

Packages

No packages published

Languages