# phpfilebrowser — Project Instructions ## Overview Single-file PHP file browser. No external dependencies. Dark modern theme, responsive, mobile-optimized. ## Architecture ``` phpfilebrowser/ ├── AGENTS.md # This file — project state & agent instructions ├── index.php # Single-file application (PHP backend + CSS + JS inline) └── .gitignore ``` ## Current State **Step 1 — Project Setup:** `in_progress` (2026-06-09) - Project directory created - AGENTS.md created - Git repo not yet initialized - Gitea remote not yet configured ## Implementation Plan ### Step 1: Project Setup - [x] Create project directory - [x] Create AGENTS.md - [ ] Create .gitignore - [ ] Git init, configure, push to Gitea ### Step 2: PHP Backend (`index.php` — backend portion) - [ ] Read directory contents (realpath-based, no traversal) - [ ] Return JSON for current directory listing - [ ] Handle relative path from query param (`?path=`) - [ ] Return metadata: name, type (dir/file), size, modified date ### Step 3: Frontend — CSS (dark, modern, responsive) - [ ] Dark color scheme with CSS variables - [ ] Responsive table layout (stack on mobile) - [ ] Navigation bar with breadcrumb - [ ] Back/Forward browser-style navigation buttons - [ ] Filter input styling - [ ] Media player overlay styling - [ ] Sortable column headers with indicators - [ ] File type icons (inline SVG) ### Step 4: Frontend — Table & Sorting - [ ] Render file/folder table from JSON data - [ ] Clickable rows (folders navigate, files trigger action) - [ ] Client-side sort by name, date, size (asc/desc) - [ ] Sort state persisted in filter bar ### Step 5: Frontend — Filtering - [ ] Text filter input (regex or substring match) - [ ] Filter applied to table rows in real-time ### Step 6: Frontend — Media Player Overlay - [ ] Detect media file types (audio/video/image) - [ ] Open overlay with embedded `