Files
phpfilebrowser/AGENTS.md
T
Johann 7bb9b9b1b0 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
2026-06-09 16:29:40 +02:00

3.0 KiB

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

  • Create project directory
  • 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