TRCKR-512 - trckr

← TRCKR-512

bug,backend,blocker

Created: 2025-12-18 • Updated: 2025-12-19

Relationships Loading...

## Problem

The FastAPI server is not configured to serve static files. All requests to `/static/*` URLs return 404 Not Found.

## Impact

**BLOCKS 8 ISSUES:**
- TRCKR-459 (Milkdown toolbar/theme)
- TRCKR-460 (Milkdown wrapper)
- TRCKR-461 (Document forms)
- TRCKR-462 (Issue create form)
- TRCKR-463 (Issue detail edit)
- TRCKR-464 (Project form)
- TRCKR-465 (Comment forms - partial)
- TRCKR-466 (Milkdown E2E tests)

## Root Cause

The `server/main.py` file does not mount the static files directory. The files exist in `server/static/` but are not accessible via HTTP.

## Evidence

```bash
$ curl -o /dev/null -w '%{http_code}' http://localhost:8000/static/js/milkdown-bundle.js
404

$ ls -la server/static/js/milkdown-bundle.js
-rw-r--r--  1 joe  staff  366864 Dec 17 20:45 server/static/js/milkdown-bundle.js
```

## Required Fix

Add to `server/main.py` in the `create_app()` function:

```python
from fastapi.staticfiles import StaticFiles
from pathlib import Path

# After including routers:
static_dir = Path(__file__).parent / "static"
if static_dir.exists():
    app.mount("/static", StaticFiles(directory=static_dir), name="static")
```

## Acceptance Criteria

- [ ] `/static/js/milkdown-bundle.js` returns 200 OK
- [ ] `/static/js/markdown-editor.js` returns 200 OK
- [ ] `/static/css/milkdown-theme.css` returns 200 OK
- [ ] All Milkdown editors load correctly in browser
- [ ] No console errors for missing static resources

## Discovered By

QA verification agents during plow workflow - found in 8 separate QA reports.

Pull Requests (comma-separated URLs)

Attachments

Comments (1)

agent · 2025-12-18

## Fix Applied Added static file serving to FastAPI server in `server/main.py`: 1. Added import: `from fastapi.staticfiles import StaticFiles` (line 12) 2. Added static mount after router includes (lines 98-101): ```python static_dir = Path(__file__).parent / "static" if static_dir.exists(): app.mount("/static", StaticFiles(directory=static_dir), name="static") ``` ## Verification Tested locally with curl requests: - `/static/js/milkdown-bundle.js` - 200 OK - `/static/js/markdown-editor.js` - 200 OK - `/static/css/milkdown-theme.css` - 200 OK All acceptance criteria met. Test suite passes (1 pre-existing unrelated failure in test_agent_detection exists on main branch as well). This unblocks 8 dependent issues for Milkdown editor integration.