This is a Next.js project bootstrapped with create-next-app.

IPC Debugger

An interactive Inter-Process Communication (IPC) debugger and simulator for visualizing and analyzing process communication, message queues, and shared memory.

Getting Started

1. Start the Backend Server

First, install Python dependencies and start the FastAPI backend:

cd backend
pip install -r requirements.txt
python main.py

The backend server will start on http://localhost:8000.

2. Start the Frontend Development Server

In a separate terminal, run the Next.js development server:

npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev

Open http://localhost:3000 with your browser to see the application.

Backend Connection Status

• Green "● Online": Backend is connected and ready
• Yellow Banner: Attempting to connect to backend
• Red "○ Offline": Backend is not running or unreachable

If you see the offline status, make sure the backend server is running on port 8000.

Features

Simulation Controls

• Start/Pause: Begin or pause the IPC simulation
• Stop: Completely stop the simulation and reset (red stop button appears when simulation is running)
• Resume: Continue a paused simulation

Node Types

• Process Nodes: Represent individual processes with PIDs
• Queue Nodes: Message queues with capacity limits
• Memory Nodes: Shared memory segments

Message Handling

• Send Now: Send messages immediately between nodes
• Schedule: Schedule messages to be sent at specific simulation times
• Real-time Tracking: View message flow with animated packets

Issue Detection

The simulator automatically detects:

• Deadlocks and circular dependencies
• Resource contention
• Queue overflow conditions
• Process starvation
• Blocking scenarios

Project Structure

• /app - Next.js application pages and layouts
• /components - React components for UI
• /lib - Utilities, hooks, stores, and types
• /backend - Python FastAPI backend for simulation engine

You can start editing the page by modifying app/page.tsx. The page auto-updates as you edit the file.

This project uses next/font to automatically optimize and load Geist, a new font family for Vercel.

Learn More

To learn more about Next.js, take a look at the following resources:

• Next.js Documentation - learn about Next.js features and API.
• Learn Next.js - an interactive Next.js tutorial.

You can check out the Next.js GitHub repository - your feedback and contributions are welcome!

Deploy on Vercel

The easiest way to deploy your Next.js app is to use the Vercel Platform from the creators of Next.js.

Check out our Next.js deployment documentation for more details.