MarkCodes
Macintosh 1984 Simulator

Macintosh 1984 Simulator

ReactThree.jsWebGLPCEMacintosh

Macintosh 1984 Simulator

Overview

Welcome to the Macintosh 1984 Simulator! This project brings the iconic 1984 Macintosh computer to life using modern web technologies, allowing you to experience the revolutionary graphical user interface of the original Macintosh in your browser. Built with Three.js, React Three Fiber, and PCE, this simulator faithfully recreates the look, feel, and functionality of the 1984 Macintosh OS.

Features

  • Authentic Experience: Interact with a simulated 1984 Macintosh, complete with its original operating system and applications.
  • Web-Based Accessibility: No downloads required—access the simulator directly through a web browser.
  • Educational Value: Explore the history of personal computing and understand the impact of the Macintosh on modern technology.
  • Open Source: Contribute to the project and help preserve computing history.

    • Getting Started

    Prerequisites

    To run or contribute to this project, you will need:

  • Node.js (version 14.x or later)
  • npm or yarn
  • A modern web browser (Chrome, Firefox, Safari, etc.)

    • Installation

  • Clone the repository:

    • git clone https://github.com/your-username/macintosh-1984-simulator.git cd macintosh-1984-simulator

  • Install dependencies:

    • npm install # or yarn install

  • Start the development server:

    • npm start # or yarn start

  • Open your browser and navigate to http://localhost:3000 to view the simulator.

    • Usage

    Once the simulator is running, you can:

  • Explore the desktop environment of the 1984 Macintosh.
  • Open and interact with classic applications like MacWrite and MacPaint.
  • Experience the original mouse-driven interface.

    • Contributing

    We welcome contributions from the community! Whether you're a developer, historian, or enthusiast, your input is valuable.

    How to Contribute

  • Fork the repository.
    • Create a new branch for your feature or bug fix:

    git checkout -b feature/your-feature-name

  • Make your changes and commit them:

    • git commit -m "Add your commit message here"

  • Push to the branch:

    • git push origin feature/your-feature-name

  • Submit a pull request.

    • Code of Conduct

    Please adhere to our Code of Conduct (CODE_OF_CONDUCT.md) to ensure a welcoming and inclusive environment for all contributors.

    License

    This project is licensed under the MIT License. See the LICENSE file for details.

    Acknowledgments

  • Apple Inc. for the original Macintosh and its groundbreaking interface.
  • The open-source community for tools like Three.js, React Three Fiber, and PCE.
  • All contributors who have helped shape this project.

    • Contact

    For questions, suggestions, or feedback, please reach out to:

  • Mark Shenouda: Twitter (https://x.com/MarkSShenouda) | GitHub (https://github.com/MarkSShenouda)
  • Email: mark.shenouda@example.com

    • Screenshots

    Include screenshots or a video demonstration of the simulator in action to give users a visual understanding of the project.

    Macintosh 1984 Simulator Screenshot

    Additional Resources

  • Original Macintosh 1984 Announcement (https://www.apple.com/macintosh/)
  • Three.js Documentation (https://threejs.org/docs/)
  • React Three Fiber (https://docs.pmnd.rs/react-three-fiber/getting-started/introduction)

    • Challenges

    • Creating a 3D environment of the original Macintosh 1984 computer
    • Implementing a mouse-driven interface
    • Adding classic applications like MacWrite and MacPaint

    Solutions

    • Used Three.js and React Three Fiber for 3D rendering
    • Designed with custom UI components for consistent UI
    • Implemented PCE for emulating the original Macintosh 1984 computer

    Project Details

    Date
    2023-02-15
    Author
    Mark Shenouda
    Category
    Web
    Technologies
    ReactThree.jsReact Three FiberPCE
    GitHub Repository Live Demo