🔮 NEXUS — Personal Future Simulator

“See where your daily habits are mathematically taking you.”

NEXUS is an AI-powered personal growth and future trajectory simulator.
Not a passive to-do list. Not a basic habit tracker. A true predictive operating system for your ambition.

🚀 Live Demo • 🌟 Core Features • 🎨 Multi-Theme Atmosphere • 🧮 Mathematical Formulation • 🏗️ Architecture • ⚡ Quick Start

---

🌌 The Fundamental Principle

Most habit trackers tell you what you did yesterday. NEXUS calculates who you will be tomorrow.

$$\mathbf{GOALS} + \mathbf{DAILY\ BEHAVIOR} + \mathbf{CONSISTENCY} + \mathbf{TIME} = \mathbf{PROJECTED\ FUTURE}$$

NEXUS continuously ingests your empirical daily telemetry (study volume, applied project commits, algorithmic practice, streak stability), runs deterministic differential trajectory equations, and renders multi-path simulated futures in real time.

---

🌟 Core Features

1. ⏱️ "Simulate My Future" Temporal Stepper

Step forward in time through critical empirical milestones:

• Today (T+0): Current baseline and historical velocity index.
• +30 Days: Foundation prototype & state management operational.
• +90 Days: Applied distributed systems, database scaling & core competencies.
• +180 Days: Full production capstone launch & interview/market readiness.
• Arrival Horizon: Exact mathematically projected completion date based on rolling 7-day velocity.

2. 🎛️ "What-If" Sensitivity Sandbox

Adjust your commitment levers with 60 FPS live feedback:

• Daily Study Hours ($0.5\text{h} \rightarrow 6.0\text{h/day}$)
• Weekly Project Building ($0\text{h} \rightarrow 25\text{h/week}$)
• Weekly DSA Problem Solving ($0 \rightarrow 40\text{ problems/week}$)
• Consistency Discipline Rate ($30% \rightarrow 100%$)
• Instant Delta Metrics: Immediately inspect impacts such as +45 Days Saved or 19 Days Delayed, with a one-click "Apply to Trajectory" button.

3. 🔀 Multi-Path Alternative Scenario Engine

Simultaneously computes and visualizes three prospective lifelines:

• Path A (Status Quo): Pacing strictly at your current 28-day historical average.
• Path B (Balanced Trajectory): $+35$ min daily, $+2$h weekend project focus (sustainable acceleration).
• Path C (High Intensity Sprint): $+2$h daily aggressive tempo with burnout vulnerability warning models.

4. 🎨 Multi-Theme Atmospheric Engine

Switch between 5 custom crafted visual atmospheres on the fly:

• 🌌 Obsidian Void (Default): Deep space obsidian with cyan neon & purple radial aura.
• 🌃 Midnight Cyber: Abyssal navy with electric blue & hot magenta glow.
• 🟩 Matrix Terminal: Retro cybernetic green on obsidian terminal console.
• 🌅 Solar Sunset: Warm cosmic dusk with golden amber & crimson dawn radiance.
• ☀️ Clean Horizon: High-contrast modern architectural slate & vivid indigo.

5. 🧠 AI Goal Decomposer & Roadmap Architect

• Transform high-level ambitions (e.g. "Become a Senior AI Engineer in 6 months") into structured technical milestones.
• Automatically generates estimated hour quotas, skill tags, and daily pacing requirements.

6. 🩺 Diagnostic AI Telemetry Life Coach

• Zero generic motivational platitudes.
• Direct analytical diagnosis based on your 28-day telemetry stream:

  "Your applied project velocity exceeds the milestone baseline by 18%, but algorithmic practice logged only 2 sessions this week. This introduces a technical interview vulnerability for your Q3 goal."

7. 📊 Mathematical Progress Telemetry (Recharts)

• Benchmark Curve: Optimal planned trajectory.
• Empirical Hours Log: Exact 28-day historical performance.
• Projected Future Vector: Forward trajectory curve.
• Uncertainty Corridor: 88% confidence interval band accounting for real-world variance.
• Effort Breakdown: Theory & Concept vs. Applied Implementation distribution.

8. 📱 Mobile First & Floating Thumb Navigation

• Glassmorphism bottom navigation bar for seamless one-handed navigation on mobile devices.
• Adaptive battery-saving particle engine (auto-pauses when browser tab is inactive).

---

🧮 Mathematical Formulation

NEXUS does not guess. It computes trajectories using deterministic differential models:

1. Effective Daily Velocity ($V_{\text{eff}}$)

$$V_{\text{eff}} = \left( H_{\text{daily_study}} + \frac{H_{\text{weekly_project}}}{7} \right) \times C_{\text{factor}} \times F_{\text{focus}}$$

Where:

• $H_{\text{daily_study}}$ = Empirical daily study hours logged
• $H_{\text{weekly_project}}$ = Weekly project development hours
• $C_{\text{factor}}$ = Habit consistency ratio ($0.30 \le C \le 1.0$)
• $F_{\text{focus}}$ = Deep work quality modifier ($0.85 \le F \le 1.15$)

2. Projected Completion Horizon ($D_{\text{projected}}$)

$$D_{\text{projected}} = \left\lceil \frac{H_{\text{remaining}}}{V_{\text{eff}}} \right\rceil$$

3. Momentum Derivative ($\Delta M$)

$$M = \alpha \cdot \text{Streak}_{\text{norm}} + \beta \cdot C_{\text{rolling7}} + \gamma \cdot \left(\frac{V_{\text{recent}}}{V_{\text{target}}}\right)$$

---

🏗️ System Architecture

nexus/
├── .github/
│   └── workflows/
│       └── deploy.yml          # Automated GitHub Pages CI/CD deployment
├── src/
│   ├── app/
│   │   ├── globals.css         # Tailwind CSS v4 variables & custom animations
│   │   ├── layout.tsx          # Root HTML metadata & font injection
│   │   └── page.tsx            # Main shell with Framer Motion transitions
│   ├── components/
│   │   ├── background/         # Dynamic Canvas 2D Particle System
│   │   ├── dashboard/          # Trajectory hero banner & velocity telemetry
│   │   ├── simulation/         # Temporal Stepper & future horizon viewer
│   │   ├── whatif/             # Live parameter sensitivity sandbox
│   │   ├── navigation/         # Sidebar, Topbar & Mobile Bottom Navigation
│   │   ├── settings/           # Theme picker, JSON export & telemetry reset
│   │   └── ui/                 # Reusable atomic UI components
│   ├── lib/
│   │   ├── constants/          # Themes & color palettes
│   │   ├── simulation/         # Deterministic trajectory mathematical engine
│   │   ├── store/              # NexusContext state & LocalStorage persistence
│   │   └── ai/                 # Goal decomposition & diagnostic coach
│   └── types/                  # TypeScript interface contracts
└── next.config.ts              # Static export configuration for GitHub Pages

---

⚡ Quick Start

Prerequisites

• Node.js >= 18.18.0 (Node 20+ recommended)
• npm, pnpm, or yarn

Installation

# 1. Clone the repository
git clone https://github.com/baadaldev/nexus-future-simulator.git

# 2. Enter project directory
cd nexus-future-simulator

# 3. Install dependencies
npm install

# 4. Start local development server (Turbopack)
npm run dev

Open http://localhost:3000 in your browser.

Production Build

# Build static site for production deployment
npm run build

---

🚀 GitHub Pages Deployment

The repository includes a zero-configuration GitHub Actions workflow (.github/workflows/deploy.yml).

To make your fork or repository live:

1. Go to your repository Settings on GitHub.
2. Navigate to Pages (under Code and automation).
3. Under Build and deployment > Source, select GitHub Actions.
4. Push to main — GitHub Actions will automatically compile and deploy the site!

---

⌨️ Keyboard Shortcuts

Shortcut	Action
Ctrl + K / ⌘ + K	Open Global Omnisearch
Esc	Close active modal / popover
Tab	Navigate interactive controls

---

📄 License

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

---

Crafted with passion by Md Rakibul Islam (@baadaldev)
“The future belongs to those who build it today.”