Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/misogare/laravel-portfolio-with-threejs
LaraVision Portfolio is an interactive 3D portfolio application built using Laravel and Three.js.
https://github.com/misogare/laravel-portfolio-with-threejs
artisan boostrap cicd composer env javascript laravel laravel-framework laravel10 mysql php php8 portfolio vite vue vue3 webpack
Last synced: about 5 hours ago
JSON representation
LaraVision Portfolio is an interactive 3D portfolio application built using Laravel and Three.js.
- Host: GitHub
- URL: https://github.com/misogare/laravel-portfolio-with-threejs
- Owner: misogare
- License: gpl-3.0
- Created: 2024-04-12T07:45:02.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2024-04-12T08:16:10.000Z (6 months ago)
- Last Synced: 2024-09-23T16:32:54.904Z (4 days ago)
- Topics: artisan, boostrap, cicd, composer, env, javascript, laravel, laravel-framework, laravel10, mysql, php, php8, portfolio, vite, vue, vue3, webpack
- Language: PHP
- Homepage: https://laravel-portfolio-with-three-js.vercel.app
- Size: 72.5 MB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# LaraVision Portfolio
## Description
LaraVision Portfolio is an interactive 3D portfolio application built using Laravel and Three.js. This project leverages pre-made 3D model designs stored in GLTF format within the `public` folder. GLTF is a compressed version of traditional 3D model formats like FBX, offering efficient loading and handling of complex models.
The Three.js script, responsible for all 3D model interactions, is located in `resources/js/portfolio.js`. When you run `npm run dev`, Vite provides hot module replacement (HMR), which automatically updates the portfolio page as you make changes to `portfolio.js`—no need to reload or restart your service.
The application's structure follows the MVC pattern. Navigation between pages is handled by Laravel's routing, with `home.blade.php` redirecting to `portfolio.blade.php`. There are two main controllers: `HomeController` and `PortfolioController`, which manage the respective views.
If you are new to Laravel and need to modify or add new pages, it is recommended to check the Laravel documentation to understand how to work with views, routes, and controllers effectively.
## Prerequisites
Before you begin, ensure you have met the following requirements:
- PHP >= 7.3
- Node.js >= 12.x
- Composer
## Note
click on the icon in the windows 7 screen to be able to see the portfolio website which is fetched to mine [MESVAK.SOFTWARE](https://mesvak.software/)
## Installation
Follow these steps to get your development environment running:
1. **Clone the repository:**
```bash
git clone https://github.com/yourusername/laravision-portfolio.git
cd laravision-portfolio
```
2. **Install PHP dependencies:**
```bash
composer install
```
3. **Install JavaScript dependencies:**
```bash
npm install
```
4. **Compile assets with Vite:**
```bash
npm run dev # For development
npm run build # For production
```
5. **Copy the example environment file and make the required configuration changes in the .env file:**
```bash
cp .env.example .env
```
6. **Generate a new application key:**
```bash
php artisan key:generate
```
7. **Run the database migrations (Set the database connection in .env before migrating)**
```bash
php artisan migrate
```
8. **Start the local development server:**
```bash
php artisan serve
```
## Usage
After installation, you can open your web browser and visit `http://localhost:8000` to view the application.
## Credits
This project makes use of several open-source packages and resources:
- Laravel (https://laravel.com)
- Three.js (https://threejs.org)
- Vite (https://vitejs.dev)
- Inspiration from [Henry Hefferman] (https://henryheffernan.com/)
- The modules [shedmon] (https://sketchfab.com/shedmon)
- The modules [Anthony Yanez ] (https://sketchfab.com/paulyanez)
- The modules [1056878 )] (https://sketchfab.com/1056878
- The modules [edArieL] (https://sketchfab.com/edArieL)
## Contributing
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.
## License
Distributed under the MIT License. See `LICENSE` for more information.
## Contact
MESVAK – [@mesvak](https://www.instagram.com/mesvak/) - [mesvak](https://t.me/mesvak) - [email protected]
Project Link: [lARAVISION](https://github.com/misogare/Laravel-Portfolio-With-ThreeJs)