DevOS is a zero-config Vite project. You can have a fully interactive OS-themed portfolio running locally in under five minutes — and personalised with your own data in a few more. This guide walks you from a fresh clone to a customised desktop.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/apursley2012/dev-os/llms.txt
Use this file to discover all available pages before exploring further.
Prerequisites: Node.js 18+ and Git must be installed on your machine before you begin.
Install dependencies
Install all Node packages declared in
package.json (React 18, Tailwind CSS, Framer Motion, Lucide React, and Vite):Start the development server
Vite compiles the project and serves it with hot module replacement:The terminal will confirm the local address. Open your browser and navigate to:
Experience the boot screen
You will see a black terminal screen stream a sequence of boot messages — including the deliberately failed
impostor-syndrome.dll — before the login prompt appears. Click Login to Desktop to enter the desktop environment.Open your first window
On the desktop you will find nine icon-labeled files arranged in a column grid. Double-click any icon to open it as a floating, draggable window. Try
README.md first — it renders the Home app with a welcome view of your portfolio. Minimise, maximise, and drag windows to explore the window manager.Personalise your portfolio data
All content lives in See Apps Overview for a detailed guide to each application’s data shape.
components/apps/. Open any file in that directory and replace the placeholder data with your own:Build for Production
When you are ready to deploy, generate an optimised static bundle:dist/ directory. Upload that folder to any static host — Vercel, Netlify, GitHub Pages, or an S3 bucket — and your OS-themed portfolio is live.