◉ IMPULSE

ONE TAP · ONE IMPULSE · MAXIMUM CHAIN

A minimalist one-touch chain-reaction puzzle for Android.

Particles drift across a near-black field. You get one tap. That tap creates an expanding impulse; every particle it reaches can become another wave, and every new wave can continue the reaction. The entire attempt is decided by that single moment.

Current source version: 1.1.0 (versionCode 16) · Min SDK: 26 (Android 8.0) · Target SDK: 37

1. Watch the field.
2. Tap once to place your only impulse.
3. Let the wave trigger nearby particles.
4. Use Standard particles, Boosters, delayed Fuses, and fixed Anchors to extend the reaction.
5. Reach the target before the chain dies out.
6. Improve deterministic challenges across Campaign, Endless, and Daily Impulse.

One tap. One impulse. Maximum chain.

• One-touch gameplay with a single impulse per attempt
• 60 deterministic campaign levels in six ten-level chapters
• Chapters: Impulse, Momentum, Boost, Control, Resonance, Chaos
• Standard, Booster, Fuse, and Anchor particles with distinct behavior and visual language
• Contextual onboarding and chapter introductions
• Level unlocking, chapter-aware picker, score, 1–3 stars, and local best-result tracking
• Endless mode with seeded 40-field cycles, no field repeats inside a cycle, escalating targets, and persistent best round/run score
• Daily Impulse derived entirely from the device-local calendar date, with one stable challenge per day and unlimited retries
• Share Result through the native Android Sharesheet with no network permission
• 25 local achievements across Journey, Mastery, Chain, Endurance, and Replay
• Local statistics for campaign and replay attempts, wins, triggered particles, best chain and depth
• Fully offline adaptive procedural ambient music that subtly reacts to chain depth
• Sound, haptics, Reduced Effects, and persistent High Contrast accessibility controls
• Local persistence through AndroidX DataStore
• Deterministic fixed-step 60 Hz simulation and instant retries
• English and Russian interface resources
• Portrait-first Android experience
• No account, backend, analytics, ads, cloud dependency, or INTERNET permission

Levels use stable seeds, so retries reproduce the same logical challenge. Campaign balance is protected by deterministic difficulty regression tests that sample tap position and timing across all 60 levels.

Endless creates a run from the 40 advanced campaign fields. A run seed chooses a permutation that visits all 40 fields before any repeat. After each complete cycle the target tightens, and one failed round ends the run. Best round and best run score are stored locally.

Daily Impulse maps the local calendar date to one advanced deterministic field. The challenge stays identical for that date, can be retried without limit, and stores the day's best score and stars plus the number of completed Daily challenges.

Replay result cards can be sent to any compatible app through Android's native Sharesheet. Sharing is user-initiated and does not require IMPULSE itself to have network access.

IMPULSE is designed around clarity and escalation rather than visual noise. Cool cyan idle particles, a single cyan player impulse, pink Boosters, gold Fuses, blue Anchors and neon reaction feedback make propagation readable without changing the deterministic simulation.

The adaptive ambient layer is generated locally at runtime: a calm low-register pad stays unobtrusive while a subtle harmonic layer rises with deeper reactions. It stops outside active gameplay and can be disabled independently from sound effects.

Reduced Effects lowers visual intensity while preserving gameplay information. High Contrast adds a stronger field boundary, brighter wave and particle outlines, and thicker shape markers so Booster, Fuse, and Anchor mechanics remain readable without relying on color alone.

Rendering can run at the display refresh rate while gameplay remains deterministic through a fixed 60 Hz simulation.

Official signed APK and AAB builds are published through GitHub Releases with SHA-256 checksums and GitHub artifact attestations.

The repository is publicly visible for project transparency and review. Public visibility does not grant permission to copy, build, modify, execute, redistribute, or otherwise use the source code or assets. See LICENSE.

Android 8.0 or newer is required.

Requirements: JDK 17, Android SDK 37, and Gradle 9.7.1 through the repository Gradle Wrapper.

./gradlew testDebugUnitTest lintDebug assembleDebug

Windows:

.\gradlew.bat testDebugUnitTest lintDebug assembleDebug

Gameplay state and simulation remain separate from rendering. Campaign and replay progress, statistics, achievements, and preferences remain local to the device.

Pull requests and pushes to main are checked with unit tests, Android Lint, debug/release assembly, API 37 runtime instrumentation tests, CodeQL, Semgrep and Gitleaks. Scheduled/manual Qodana and weekly minimum-API runtime coverage complement the required checks.

The protected main branch requires configured verification checks before squash merge. Third-party GitHub Actions are pinned to immutable commit SHAs and workflow permissions follow least privilege.

Security issues should be reported according to SECURITY.md.

Official releases are tag-driven with vMAJOR.MINOR.PATCH tags matching versionName. The release workflow validates source version and required checks, uses the owner-provided signing identity, verifies APK/AAB signatures and certificate identity, generates SHA-256 checksums and artifact attestations, then publishes the GitHub Release. Signing secrets and keystore material are never stored in the repository.

See docs/RELEASE.md.

• Offline by design; no Android INTERNET permission
• No account, analytics, tracking, advertising, or backend
• Campaign/replay progress, statistics, achievements, and settings stay on the device
• Daily Impulse uses only the device-local calendar date
• Adaptive music is synthesized entirely on-device
• Sharing is explicitly initiated through the Android Sharesheet
• No dangerous Android runtime permissions in the current scope

• English — default
• Русский

The original 1.0 roadmap is complete: Campaign, special particles, chapters and achievements, Replayability, adaptive audiovisual polish, accessibility controls, regression hardening, and production release readiness are all implemented.

Future updates can focus on additional content and polish without changing the one-tap core.

The product direction is tracked in PROJECT.md.

• CHANGELOG.md
• GitHub Releases

Bug reports and suggestions are welcome. Source-code, asset, documentation, or other contributions are accepted only when explicitly agreed in advance by the copyright owner. Project-specific rules are documented in AGENTS.md.

IMPULSE is proprietary software. Copyright © 2026 Stanley Lloyd. All rights reserved.

All original project code, assets, documentation, game design, and other original materials are owned by Stanley Lloyd. No permission is granted to copy, modify, build, execute, redistribute, publish, sublicense, sell, create derivative works from, or otherwise use any part of the project except where required by applicable law, GitHub's platform terms, or prior written permission from the copyright owner.

Third-party dependencies remain under their respective licenses. See LICENSE.

Stanley Lloyd · @StanleyLl0yd