Initial commit

README.md

@@ -0,0 +1,27 @@
+# Driveboard
+
+Driveboard is a Vite + React app that presents a nested file structure with a Google Drive-inspired browsing experience.
+
+## Features
+
+- Browse a mock drive hierarchy from the sidebar tree or the main content area.
+- Connect a local directory from the in-app Settings panel by entering a filesystem path.
+- Search folders, files, file types, and locations across the whole active source.
+- Switch between a compact list view and a card-based browsing view.
+- Inspect the currently selected file or folder in the details panel.
+- Use a responsive layout that works across desktop and mobile widths.
+
+## Scripts
+
+- `npm install` to install dependencies.
+- `npm run dev` to start both the Vite frontend and the local filesystem API.
+- `npm run build` to create a production build.
+- `npm run preview` to preview the production build alongside the local filesystem API.
+- `npm run start` to serve the built app and the local filesystem API from Node.
+
+## Notes
+
+- The sample fallback data still lives in `src/data/driveData.js`.
+- Local filesystem access now runs through the bundled Node API in `server/index.js`.
+- The selected directory path is stored in browser local storage and restored on the next launch when the local API is available.
+- This avoids the browser upload flow because the app reads the directory from disk through the local backend instead of importing files into the page.