NeuralPulse

Daily brain training. Free, open source, playable in your browser.

NeuralPulse is an open-source brain training web app. Think Elevate or Lumosity, but free. No subscriptions, no ads, no data harvesting. Just 13 games that measure and track your cognitive performance over time.

Why I Built It

Brain training apps charge $5–15/month for what is fundamentally a collection of mini-games with progress tracking. I wanted to prove you can build something comparable — with radar charts, calendar heatmaps, streak tracking, daily challenges, and offline support — and give it away. NeuralPulse is the result.

Games

Game	Skill	Description
Quick Equations	Numeracy	True or false? Rapidly verify math equations under time pressure.
Math Sprint	Numeracy	Solve arithmetic problems against the clock. 3 difficulty levels.
Memory Match	Memory	Flip cards and find matching pairs. Train your visual short-term memory.
Memory Matrix	Memory	Memorize highlighted tiles and reproduce the pattern on an expanding grid.
Sequence Memory	Memory	Watch tiles light up in a sequence, then tap them back in order. Simon-style.
Stroop Match	Focus	Identify the ink color, not the word itself.
Speed Tap	Reflexes	React as fast as you can when the signal changes. Measure your response time.
Word Twist	Vocabulary	Unscramble letters to form words. Expand your mental agility.
Star Battle	Logic	Place one star in each row, column, and region. No two stars may touch.
Digit Span	Memory	Remember and recall sequences of digits. Gets harder each round.
Flanker Task	Focus	Identify the center arrow while ignoring distracting flanking arrows.
Reaction Grid	Reflexes	Tap targets that appear on a grid as fast as you can.
Pattern Matrix	Logic	Find the missing piece in a 3x3 pattern. Raven's matrices style.

Features

• 13 brain games: memory, math, reflexes, vocabulary, focus, and logic
• Daily Challenge: 3-game sequence, same for everyone (like Wordle)
• Stats dashboard: skill radar charts, trend sparklines, calendar heatmap, personal bests
• Streak tracking: consecutive daily completions with heatmap calendar
• Share scores: Wordle-style text card for daily challenge results
• Guest mode: works offline in IndexedDB — no account required
• Optional account: sync progress across devices via Supabase (Google OAuth / magic link)
• Mobile-first: touch-optimized, PWA installable, safe-area-aware
• Free and open source (MIT)

Tech Stack

• Next.js 16: server-rendered React, deployed on Vercel
• TypeScript: full type safety
• Tailwind CSS: utility-first styling
• Zustand: lightweight global state (progress, toasts)
• IndexedDB (idb): offline-first game storage
• Supabase: optional account sync (Postgres + Auth)

Self-Hosting

To run NeuralPulse locally or deploy your own instance:

1. Clone the repo:

   git clone https://github.com/sleuthy-sloth/NeuralPulse.git
   cd NeuralPulse

2. Install dependencies:

   npm install

3. Set up Supabase (optional, app works without it for guest mode):

   • Create a project at supabase.com
   • Run the migration in supabase/migrations/001_initial_schema.sql via the SQL Editor
   • Enable Google OAuth + Email Magic Link in Auth > Providers
   • Copy your project URL and anon key

4. Configure environment:

   cp .env.example .env.local
   # Edit .env.local with your Supabase credentials

5. Run locally:

   npm run dev

6. Deploy to Vercel:

   • Push to GitHub, Vercel auto-deploys from main
   • Set environment variables in Vercel dashboard:
     • NEXT_PUBLIC_SUPABASE_URL
     • NEXT_PUBLIC_SUPABASE_ANON_KEY
   • Configure Supabase Auth redirect URLs to point to your Vercel domain

Development

npm run dev      # local dev server
npm run build    # production build
npm run test     # run tests

License

MIT — see LICENSE.