4D Manifold Baryon Visualization

This project presents an interactive 3D mathematical modeling tool for visualizing baryon formation under the 4D Manifold hypothesis. It provides a dynamic and educational platform to explore how fundamental particles, represented as topological defects, merge to form stable structures like protons and neutrons.

Overview

The 4D Manifold hypothesis proposes that:

• Fundamental particles are non-orientable topological defects in 4D spacetime
• Quarks are sub-4D Manifolds with Klein bottle topology
• Baryons form through the merger of three sub-4D Manifolds

This application visualizes the "merger" of three quark sub-4D Manifolds into a single, stable baryon, demonstrating concepts like color confinement and mass generation through binding energy.

Features

• Interactive 3D Visualization: Real-time rendering of Klein bottle manifolds using Three.js
• Mathematical Accuracy: All visualizations are based on the physical properties defined in the 4D Manifold mathematical framework
• Educational Tools: Comprehensive analysis and mathematical formula displays
• Real-time Physics: Dynamic simulation of baryon formation with color confinement
• Advanced Controls: Fine-tuned parameters for exploration and analysis

Technology Stack

• Application Framework: Next.js (React)
• Language: TypeScript
• 3D Rendering: Three.js, @react-three/fiber, @react-three/drei
• Styling: Tailwind CSS with shadcn/ui components
• Database: PostgreSQL
• Containerization: Docker & Docker Compose
• CI/CD: GitHub Actions

Project Structure

The project is organized as a monorepo with the following structure:

/
├── .github/workflows/        # CI/CD pipeline configuration
├── documents/                # Project documentation and update logs
├── 4d-manifold-baryon-demo/
│   └── app/                  # The core Next.js application source code
├── .env.example              # Example environment variables
├── docker-compose.yml        # Docker service orchestration
└── README.md                 # This file

Getting Started

Follow these instructions to get the project up and running on your local machine.

Prerequisites

• Git
• Node.js (v20 or later)
• Docker

1. Clone the Repository

git clone <repository-url>
cd Baryon

2. Configure Environment Variables

Create a .env file in the project root by copying the example file.

cp .env.example .env

Review the .env file and ensure the variables are set correctly. The default values are configured to work with the docker-compose.yml setup.

# .env
POSTGRES_USER=postgres
POSTGRES_PASSWORD=skb_secure_password_2025
POSTGRES_DB=skb_baryon_db
NEXT_PUBLIC_APP_URL=http://localhost:3000
DATABASE_URL=postgres://postgres:skb_secure_password_2025@db:5432/skb_baryon_db

3. Build and Run the Application

Use Docker Compose to build the images and start the services.

docker compose up --build -d

This command will:

• Build the Docker image for the Next.js application.
• Pull the official PostgreSQL image.
• Start both containers and connect them on a shared network.

4. Access the Application

Once the containers are running, you can access the 4D Manifold Baryon Visualization in your browser at:

http://localhost:3000

The PostgreSQL database will be running and accessible on port 5432.

Available Scripts

The following scripts are available in the 4d-manifold-baryon-demo/app/package.json file and can be run inside the app container:

• npm run dev: Starts the application in development mode.
• npm run build: Builds the application for production.
• npm run start: Starts the production server.
• npm run lint: Lints the codebase.

To run a command inside the container:

docker compose exec app <command>
# Example:
docker compose exec app npm run lint

Contributing

Contributions are welcome! Please feel free to open an issue or submit a pull request.

1. Fork the repository.
2. Create your feature branch (git checkout -b feature/AmazingFeature).
3. Commit your changes (git commit -m 'Add some AmazingFeature').
4. Push to the branch (git push origin feature/AmazingFeature).
5. Open a Pull Request.

License

This project is unlicensed. Please add a license file if you wish to distribute it.