diff options
| author | diogo464 <[email protected]> | 2025-08-11 11:51:39 +0100 |
|---|---|---|
| committer | diogo464 <[email protected]> | 2025-08-11 11:51:39 +0100 |
| commit | 4af66f418b6837b6441b4e8eaf2d8ede585238b9 (patch) | |
| tree | 34a4e913a2848515166b2ac0489794419a33bfcc /CLAUDE.md | |
| parent | 0d3488a3811c8d58bd570af64cc29840df9ba439 (diff) | |
snapshot
Diffstat (limited to 'CLAUDE.md')
| -rw-r--r-- | CLAUDE.md | 47 |
1 files changed, 47 insertions, 0 deletions
diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..f836602 --- /dev/null +++ b/CLAUDE.md | |||
| @@ -0,0 +1,47 @@ | |||
| 1 | # FCTDrive Frontend Development | ||
| 2 | |||
| 3 | ## Project Overview | ||
| 4 | - Simple Google Drive style application | ||
| 5 | - Next.js frontend with TypeScript and TailwindCSS | ||
| 6 | - CLI tool (`fctdrive`) handles all drive logic - NOT my responsibility | ||
| 7 | |||
| 8 | ## Important Constraints | ||
| 9 | - **DO NOT** create new drive functions in drive.ts | ||
| 10 | - **DO NOT** attempt hacks or workarounds with the CLI tool | ||
| 11 | - If I encounter problems with the CLI tool: STOP, report problem, wait for fix | ||
| 12 | |||
| 13 | ## Available Commands | ||
| 14 | - `just build` - Build the CLI tool | ||
| 15 | - `just dev` - Start development servers (uses demon to run background processes) | ||
| 16 | - `just stop` - Stop development servers | ||
| 17 | - `just logs` - View logs | ||
| 18 | |||
| 19 | ## Current Implementation | ||
| 20 | - Frontend directory: `frontend/` | ||
| 21 | - Drive functions: `frontend/lib/drive.ts` | ||
| 22 | - `Drive_ls(path, recursive)` - Lists files/directories | ||
| 23 | - `Drive_blob_path(blob)` - Gets filesystem path for a blob ID | ||
| 24 | - Current page shows basic Next.js template but calls Drive_ls("/", false) | ||
| 25 | |||
| 26 | ## Tech Stack | ||
| 27 | - Next.js 15.4.6 with App Router | ||
| 28 | - React 19.1.0 | ||
| 29 | - TypeScript 5 | ||
| 30 | - TailwindCSS 4 | ||
| 31 | - Geist fonts | ||
| 32 | |||
| 33 | ## Development Workflow | ||
| 34 | 1. Use `just dev` to start servers | ||
| 35 | 2. Frontend runs on localhost:3000 | ||
| 36 | 3. Make changes, auto-reload enabled | ||
| 37 | 4. Use `just stop` to stop servers | ||
| 38 | |||
| 39 | ## Requirements Summary | ||
| 40 | - **UI**: Clean, simple, information-dense table for files/directories | ||
| 41 | - **Scope**: Only file browsing for now (no upload/auth) | ||
| 42 | - **File Handling**: All file types supported, clicking downloads file | ||
| 43 | - **Error Handling**: Crash on CLI errors (for now) | ||
| 44 | - **Mobile**: Must be mobile-friendly | ||
| 45 | - **Architecture**: Server-side rendering, modular reusable components | ||
| 46 | - **Updates**: Manual refresh only (no real-time) | ||
| 47 | - the server is running at `127.0.0.1:3000` and you can use curl to test the page \ No newline at end of file | ||