scorchOS is my personal website, portfolio, blog, and playground, mixing my own aesthetic combined with taking inspiration from my favorite parts of macOS, command line interfaces and modern web applications. It is built primarily with Laravel, Inertia.js, Vue.js, Tailwind CSS.
- Laravel: 12.x
- Vue.js: 3.x
- Inertia.js: 2.x
- Tailwind CSS: 4.x
- Node.js: 24.x
- PHP: 8.3+
To set up and run the project locally, follow these steps:
-
Ensure you have Laravel Valet installed globally. You can install it with Composer:
composer global require laravel/valet valet install
-
Clone the repository to your local machine.
-
Navigate to the project directory in your terminal.
-
Copy the
.env.examplefile to a new file named.env:cp .env.example .env
-
Install the project dependencies by running:
composer install
-
Generate an application key:
php artisan key:generate
-
Link the project with Valet to enable automatic
.testdomain routing:valet link
-
Secure the test domain with a TLS certificate:
valet secure scorchos
-
Install Node dependencies and start Vite in development mode:
npm install npm run dev
-
Visit the application in your browser at https://scorchos.test.
Demos are auto-discovered from resources/js/components/blog/demos/. No need to register components in page files.
- Blog only: Add a
.vuefile, then in your post use::interactive[ComponentName]and addcomponents: ['ComponentName']to frontmatter (name = filename without.vue). - Playground: Add the
.vuefile, then add one entry to theCONFIGarray inresources/js/components/blog/demos/playground-experiments.ts(componentName, id, title, description, category, tags, code, language). Optionally addComponentName: 'playground-id'toCOMPONENT_TO_PLAYGROUND_IDinregistry.tsso the blog can show “View in Playground”.
This project is open-sourced software licensed under the MIT license.