feat: initial phpfilebrowser with single-file implementation
- PHP backend: directory listing, file download API - Frontend: modern dark theme, fully responsive - Features: file/folder navigation, sortable table, text filter - Media overlay: image/audio/video player with autoplay - Download trigger for non-media files - Browser history navigation (back/forward buttons) - All CSS/JS inline in single index.php, no external dependencies
This commit is contained in:
@@ -0,0 +1,2 @@
|
||||
# PHP file browser
|
||||
# (index.php and AGENTS.md are the project files)
|
||||
@@ -0,0 +1,90 @@
|
||||
# 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 `<audio>`, `<video>`, or `<img>`
|
||||
- [ ] Close button, backdrop click to close
|
||||
- [ ] Overlay is large (centered, max-width constraint)
|
||||
|
||||
### Step 7: Frontend — Download Trigger
|
||||
- [ ] Non-media files trigger browser download
|
||||
- [ ] Use `download` parameter in URL: `?file=...&download=1`
|
||||
- [ ] PHP handles Content-Disposition header
|
||||
|
||||
### Step 8: Browser Navigation
|
||||
- [ ] Push state to history on directory change
|
||||
- [ ] Back/Forward buttons in toolbar
|
||||
- [ ] URL reflects current directory: `?path=/sub/dir`
|
||||
|
||||
## Agent Instructions
|
||||
|
||||
- Write code functionally: one feature at a time
|
||||
- Verify each step works before moving to the next
|
||||
- Use git commits after each completed step
|
||||
- Keep everything in a single `index.php`
|
||||
- All CSS and JS are inline in `index.php` (no external files)
|
||||
- No external dependencies whatsoever (no CDNs, no npm, no frameworks)
|
||||
- Use only PHP built-in functions (no composer)
|
||||
- Use only vanilla JavaScript, CSS3, HTML5
|
||||
- All SVG icons must be inline
|
||||
- Follow the Dark modern design language throughout
|
||||
|
||||
## Gitea
|
||||
|
||||
- Repository: `https://git.jlserver.de/JLtec/phpfilebrowser.git`
|
||||
- API token in `~/.git-credentials` or use `https://oauth2:<token>@git.jlserver.de`
|
||||
Reference in New Issue
Block a user