Skip to content

Repository files navigation

Sequentyol

Sequentyol

Where numbers come alive


The Story

It started with a whiteboard covered in arrows and numbers.

My son had discovered the Collatz conjecture—pick any number, if it's even divide by 2, if it's odd multiply by 3 and add 1. He was convinced there was a pattern hiding in the chaos, drawing sequence after sequence, connecting numbers with lines until the whiteboard ran out of space.

"Dad, I can see it in my head but I can't draw it fast enough."

So we built Sequentyol together. What began as a simple visualizer for his 3n+1 explorations grew into something more—a playground for mathematical curiosity. We added aliquot sequences when he discovered that 220 and 284 were "best friends" (amicable numbers, as mathematicians call them). Each app is a window into the hidden structures that connect numbers in ways that still surprise us.

These tools are for anyone who's ever stared at a sequence and wondered where does it go?


Apps

Collatz

Explore the famous 3n+1 problem. Watch numbers rise and fall through hailstone sequences, visualize the branching tree of all paths to 1, and hunt for record-breaking stopping times. Every number eventually reaches 1—but the journey is where the magic lives.

Alyqon

Dive into aliquot sequences—chains of numbers linked by their divisor sums. Discover perfect numbers that equal their divisor sums, amicable pairs that point to each other, and sociable cycles that loop through mathematical friendship. Some sequences terminate, others spiral into mystery.


Monorepo Structure

sequentyol/
├── apps/
│   ├── landing/          # Landing page (sequentyol.com)
│   ├── alyqon/           # Aliquot sequence explorer
│   └── collatz/          # Collatz conjecture visualizer
├── packages/
│   ├── ui/               # @sequentyol/ui - Shared components & theming
│   └── math/             # @sequentyol/math - Shared math utilities
├── pnpm-workspace.yaml
├── turbo.json
└── tailwind.config.base.cjs

Tech Stack

  • Framework: React 18 + TypeScript
  • Build: Vite + Turborepo
  • Styling: Tailwind CSS with CSS custom properties
  • State: Zustand with persistence
  • Graphs: react-force-graph-2d (D3-based)
  • Package Manager: pnpm

Getting Started

# Install dependencies
pnpm install

# Run all apps in development
pnpm dev

# Run specific app
pnpm --filter @sequentyol/landing dev
pnpm --filter @sequentyol/alyqon dev
pnpm --filter @sequentyol/collatz dev

# Build all
pnpm build

# Build specific app
pnpm --filter @sequentyol/collatz build

Themes

All apps support three themes:

  • Light - Clean, bright interface
  • Natural - Warm, earth tones
  • Dark - Easy on the eyes

Theme preference is persisted in localStorage.

Deployment

See DEPLOYMENT.md for Cloudflare Pages deployment instructions.

License

MIT

About

Where numbers come alive. Interactive visualizers for the Collatz conjecture (3n+1) and aliquot sequences—built with a curious kid and a whiteboard full of arrows. Explore hailstone sequences, perfect numbers, amicable pairs, and sociable cycles.

Resources

Stars

1 star

Watchers

1 watching

Forks

Contributors

Languages