Skip to content

Build a visually captivating 3D portfolio with React.js and Three.js! Learn to combine interactive 3D graphics and smooth web performance to showcase your skills in an engaging way.

Notifications You must be signed in to change notification settings

cprogmer231/3d-portfolio

Repository files navigation

🌟 3D Portfolio: Showcase Your Skills in 3D! 🌟

3D Portfolio

Welcome to the 3D Portfolio repository! This project helps you build a visually captivating portfolio using React.js and Three.js. With this combination, you can create interactive 3D graphics that enhance your online presence and showcase your skills effectively.

Download the latest release here!

Table of Contents

Features

  • Interactive 3D Graphics: Engage your visitors with stunning 3D models and animations.
  • Smooth Performance: Built with performance in mind to ensure a seamless user experience.
  • Responsive Design: Your portfolio looks great on all devices, from desktops to smartphones.
  • Easy to Customize: Modify the components to fit your personal style and branding.
  • Documentation: Comprehensive guides to help you get started quickly.

Getting Started

To set up the 3D Portfolio project on your local machine, follow these steps:

  1. Clone the Repository: Open your terminal and run the following command:

    git clone https://github.com/cprogmer231/3d-portfolio.git
  2. Navigate to the Project Directory:

    cd 3d-portfolio
  3. Install Dependencies: Use npm or yarn to install the required packages:

    npm install

    or

    yarn install
  4. Run the Development Server:

    npm start

    Your application will now be running on http://localhost:3000.

Technologies Used

This project uses several technologies to create a rich user experience:

  • React.js: A JavaScript library for building user interfaces.
  • Three.js: A cross-browser JavaScript library used to create and display animated 3D graphics.
  • React-Three-Fiber: A React renderer for Three.js that makes it easier to work with 3D graphics in React.

How to Use

Once you have set up the project, you can start customizing your portfolio. Here are some key components you can modify:

  • Header: Add your name and a brief introduction.
  • About Section: Describe your skills and experiences.
  • Projects Section: Showcase your work with images and links.
  • Contact Section: Provide your contact information or links to social media.

Example Code

Here’s a simple example of how to add a 3D model to your portfolio:

import { Canvas } from '@react-three/fiber';
import { Box } from '@react-three/drei';

function App() {
  return (
    <Canvas>
      <ambientLight />
      <pointLight position={[10, 10, 10]} />
      <Box args={[1, 1, 1]} position={[0, 0, 0]}>
        <meshStandardMaterial attach="material" color="orange" />
      </Box>
    </Canvas>
  );
}

This code creates a basic 3D box in your portfolio. You can replace the Box component with any 3D model you want to display.

Project Structure

Here’s a breakdown of the project structure:

3d-portfolio/
├── public/
│   ├── index.html
│   └── favicon.ico
├── src/
│   ├── components/
│   │   ├── Header.js
│   │   ├── About.js
│   │   ├── Projects.js
│   │   └── Contact.js
│   ├── App.js
│   └── index.js
├── package.json
└── README.md
  • public/: Contains the HTML file and favicon.
  • src/: The main source folder for your React components.
  • components/: Individual components for different sections of your portfolio.

Contributing

We welcome contributions! If you want to improve this project, please follow these steps:

  1. Fork the Repository: Click on the fork button at the top right of this page.

  2. Create a Branch: Create a new branch for your feature or bug fix.

    git checkout -b feature-name
  3. Make Changes: Implement your changes and test them.

  4. Commit Your Changes:

    git commit -m "Add your message here"
  5. Push to Your Branch:

    git push origin feature-name
  6. Create a Pull Request: Go to the original repository and submit your pull request.

License

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

Contact

If you have any questions or suggestions, feel free to reach out:

For the latest releases, check the Releases section.


With this project, you can create a stunning portfolio that highlights your skills and engages your audience. Happy coding!

About

Build a visually captivating 3D portfolio with React.js and Three.js! Learn to combine interactive 3D graphics and smooth web performance to showcase your skills in an engaging way.

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 6