diff --git a/README.md b/README.md
index 06e5b70..7dc1bd4 100644
--- a/README.md
+++ b/README.md
@@ -31,7 +31,7 @@ pip install -r backend\requirements.txt
Start FastAPI:
```powershell
-uvicorn backend.main:app --reload --port 8000 --env-file backend\.env
+uvicorn backend.main:app --reload --reload-dir backend --port 8000 --env-file backend\.env
```
In a second terminal, start React:
@@ -51,14 +51,16 @@ The interface loads Roboto Flex from Google Fonts for its compact UI copy, while
The form uses `POST /api/contact` and sends email through SMTP. Copy `backend/.env.example` to `backend/.env`, fill in the SMTP values, and start the API with the environment file:
```powershell
-uvicorn backend.main:app --reload --port 8000 --env-file backend\.env
+uvicorn backend.main:app --reload --reload-dir backend --port 8000 --env-file backend\.env
```
If SMTP is unavailable, the API returns a clear delivery error and the page keeps Alex's direct email, LinkedIn, and GitHub links visible.
## Journal publisher
-Open `http://localhost:5173/blog/manage` and sign in with the journal admin password. The writing room uses Tiptap for headings, bold and italic text, lists, undo/redo, and inline font sizes. Publishing writes to Supabase when it is configured, or to `backend/data/posts.json` during local fallback mode.
+Click the lock icon beside the header navigation and enter the journal admin password. Signing in enables **New article**, **Edit**, and **Delete** controls throughout the journal. The account icon opens the admin menu and sign-out control. You can also open `http://localhost:5173/blog/manage` directly; the page prompts you to sign in before writing.
+
+The writing room uses Tiptap for headings, bold and italic text, lists, undo/redo, and inline font sizes. Creating, updating, and deleting articles uses Supabase when configured, or `backend/data/posts.json` in local fallback mode. Edit controls open `/blog/{slug}/edit` with the existing sections, formatting, topics, banner, and attachments. Editing a title preserves the published URL. Deleting an article requires confirmation and removes it from the journal; stored uploads remain available at their existing URLs.
Set unique production values in `backend/.env`:
@@ -67,11 +69,15 @@ JOURNAL_ADMIN_PASSWORD=replace-with-a-strong-password
JOURNAL_TOKEN_SECRET=replace-with-a-long-random-secret
```
-The login endpoint returns a signed session that expires after four hours. The password remains server-side and the browser stores only the temporary token.
+The login endpoint returns a signed admin session that expires after four hours. The password remains server-side and the browser stores only the temporary token. The shared session restores after refresh and expires automatically. Every create, update, delete, and upload endpoint verifies the admin token on the server.
+
+Reading the journal is public and independent of the admin session. Journal lists and article pages retry temporary failures once, refresh after successful sign-in, and offer **Try again** if the store remains unavailable. Existing content stays visible during failed refreshes. A temporary session-check failure preserves the saved token and can recover when the connection returns. Supabase reads use bounded retries and log the failure type/code without credentials or article content.
Use **+ Section** in the editor to add a section heading and opening paragraph. Section headings receive the same divider and uppercase drop cap as the starter articles, with formatting visible in the editor. Existing H2 headings use this styling automatically.
-The publisher accepts a banner image (JPEG, PNG, WebP, or GIF, up to 8 MB) and up to ten additional photos or files (20 MB each). The banner appears in the journal thumbnail and above the article title; additional photos and downloadable files appear below the body. Uploads require an admin session. File contents are saved in `backend/data/uploads` in both article storage modes; set `JOURNAL_UPLOAD_DIR` to a persistent mounted directory in production and include it in backups. Uploaded files are publicly accessible by their generated URLs. Removing a selection from an unpublished draft does not delete its stored upload.
+The media picker supports drag-and-drop or file browsing, a live banner preview with the article title and subtitle, file-size and format checks, and duplicate detection by file name and size. Uploads have individual progress, cancel, and retry controls; a failed file does not stop the remaining queue. Retry or remove pending/failed uploads before publishing. Use the up/down controls to set the order of additional photos and files. Replacing a banner keeps the previous image until the replacement uploads successfully.
+
+The publisher accepts a banner image (JPEG, PNG, WebP, or GIF, up to 8 MB) and up to ten additional photos or files (20 MB each). The banner appears in the journal thumbnail and behind the article title and subtitle with a readability overlay; additional photos and downloadable files appear below the body. Uploads require an admin session. File contents are saved in `backend/data/uploads` in both article storage modes; set `JOURNAL_UPLOAD_DIR` to a persistent mounted directory in production and include it in backups. Uploaded files are publicly accessible by their generated URLs. Removing a selection from an unpublished draft does not delete its stored upload.
For an existing Supabase project, run `bash scripts/setup_supabase.sh --schema-only` to add the nullable `banner` and default-empty `attachments` columns before running the updated backend. Existing articles remain compatible.
@@ -109,6 +115,10 @@ The access token must be project-scoped with **Database: Read-write** permission
- `POST /api/auth/login`
- `GET /api/auth/session`
- `POST /api/posts` (authenticated)
+- `PUT /api/posts/{slug}` (authenticated)
+- `DELETE /api/posts/{slug}` (authenticated)
+- `POST /api/uploads` (authenticated)
+- `GET /api/uploads/{upload_id}`
- `GET /api/resume`
- `POST /api/contact`
diff --git a/backend/main.py b/backend/main.py
index ea88a67..5dcdb1c 100644
--- a/backend/main.py
+++ b/backend/main.py
@@ -3,6 +3,7 @@ from __future__ import annotations
import hashlib
import hmac
import json
+import logging
import os
import re
import smtplib
@@ -23,7 +24,8 @@ from fastapi.middleware.cors import CORSMiddleware
from fastapi.responses import FileResponse
from pydantic import BaseModel, EmailStr, Field
from starlette.concurrency import run_in_threadpool
-from supabase import Client, create_client
+from httpx import TransportError
+from supabase import Client, ClientOptions, PostgrestAPIError, create_client
BASE_DIR = Path(__file__).resolve().parent
@@ -36,6 +38,7 @@ POSTS_LOCK = threading.Lock()
ADMIN_TOKEN_TTL = 60 * 60 * 4
UPLOAD_DIR = Path(os.getenv("JOURNAL_UPLOAD_DIR", str(DATA_DIR / "uploads"))).resolve()
MAX_UPLOAD_BYTES = 20 * 1024 * 1024
+logger = logging.getLogger("uvicorn.error")
class ArticleMedia(BaseModel):
@@ -60,7 +63,7 @@ app.add_middleware(
CORSMiddleware,
allow_origins=origins,
allow_credentials=True,
- allow_methods=["GET", "POST"],
+ allow_methods=["GET", "POST", "PUT", "DELETE"],
allow_headers=["*"],
)
@@ -111,7 +114,11 @@ def get_supabase() -> Client | None:
status_code=500,
detail="Supabase configuration is incomplete.",
)
- return create_client(url, key)
+ return create_client(url, key, options=ClientOptions(
+ postgrest_client_timeout=8,
+ auto_refresh_token=False,
+ persist_session=False,
+ ))
def articles_table() -> str:
@@ -121,6 +128,25 @@ def articles_table() -> str:
return table
+def read_article_query(query: Any) -> Any:
+ # Bound reads to two attempts, including SDK retries. Never retry mutations.
+ for attempt in range(2):
+ try:
+ return query.retry(False).execute()
+ except Exception as exc:
+ code = str(getattr(exc, "code", ""))
+ transient = isinstance(exc, TransportError) or (
+ isinstance(exc, PostgrestAPIError) and code in {"500", "502", "503", "504", "520", "522", "524"}
+ )
+ # Log the error type and code, not credentials, article data, or response bodies.
+ safe_code = code if re.fullmatch(r"[A-Za-z0-9_]{1,20}", code) else "unknown"
+ logger.warning("Journal read failed: type=%s code=%s attempt=%s", type(exc).__name__, safe_code, attempt + 1)
+ if transient and attempt == 0:
+ time.sleep(0.2)
+ continue
+ raise HTTPException(status_code=502, detail="The journal store is temporarily unavailable. Please try again.") from exc
+
+
def article_records(include_content: bool = True) -> list[dict[str, Any]]:
client = get_supabase()
if client is None:
@@ -135,18 +161,9 @@ def article_records(include_content: bool = True) -> list[dict[str, Any]]:
columns = "slug,title,excerpt,published_at,read_time,tags,accent,banner,attachments"
if include_content:
columns += ",content"
- try:
- response = (
- client.table(articles_table())
- .select(columns)
- .order("published_at", desc=True)
- .execute()
- )
- except Exception as exc:
- raise HTTPException(
- status_code=status.HTTP_502_BAD_GATEWAY,
- detail="The journal store is temporarily unavailable.",
- ) from exc
+ response = read_article_query(
+ client.table(articles_table()).select(columns).order("published_at", desc=True)
+ )
return response.data or []
@@ -263,12 +280,13 @@ def admin_login(payload: LoginPayload) -> dict[str, Any]:
"token_type": "bearer",
"expires_at": expires_at,
"expires_in": ADMIN_TOKEN_TTL,
+ "role": "admin",
}
@app.get("/api/auth/session")
-def admin_session(_: None = Depends(require_admin)) -> dict[str, bool]:
- return {"authenticated": True}
+def admin_session(_: None = Depends(require_admin)) -> dict[str, Any]:
+ return {"authenticated": True, "role": "admin"}
@app.get("/api/posts")
@@ -349,11 +367,7 @@ def download_media(upload_id: str) -> FileResponse:
)
-@app.post("/api/posts", status_code=status.HTTP_201_CREATED)
-def create_post(
- payload: NewPostPayload, _: None = Depends(require_admin)
-) -> dict[str, Any]:
- slug = post_slug(payload.title)
+def validated_article(payload: NewPostPayload, slug: str) -> dict[str, Any]:
clean_tags = list(dict.fromkeys(tag.strip() for tag in payload.tags if tag.strip()))
if not clean_tags:
raise HTTPException(status_code=422, detail="Add at least one topic tag.")
@@ -373,6 +387,25 @@ def create_post(
raise HTTPException(status_code=422, detail="The article body is too short.")
if len(json.dumps(article["content"], ensure_ascii=False)) > 250_000:
raise HTTPException(status_code=422, detail="The formatted article is too large.")
+ return article
+
+
+def save_local_posts(records: list[dict[str, Any]]) -> None:
+ # Call while holding POSTS_LOCK so readers only see a complete replacement.
+ temporary_path = POSTS_PATH.with_suffix(".json.tmp")
+ temporary_path.write_text(
+ json.dumps(records, indent=2, ensure_ascii=False) + "\n", encoding="utf-8"
+ )
+ temporary_path.replace(POSTS_PATH)
+ read_data.cache_clear()
+
+
+@app.post("/api/posts", status_code=status.HTTP_201_CREATED)
+def create_post(
+ payload: NewPostPayload, _: None = Depends(require_admin)
+) -> dict[str, Any]:
+ slug = post_slug(payload.title)
+ article = validated_article(payload, slug)
client = get_supabase()
if client is not None:
@@ -409,17 +442,62 @@ def create_post(
detail="A journal post with this title already exists.",
)
current_posts.append(article)
- temporary_path = POSTS_PATH.with_suffix(".json.tmp")
- temporary_path.write_text(
- json.dumps(current_posts, indent=2, ensure_ascii=False) + "\n",
- encoding="utf-8",
- )
- temporary_path.replace(POSTS_PATH)
- read_data.cache_clear()
+ save_local_posts(current_posts)
return article
+@app.put("/api/posts/{slug}")
+def update_post(
+ slug: str, payload: NewPostPayload, _: None = Depends(require_admin)
+) -> dict[str, Any]:
+ if not re.fullmatch(r"[a-z0-9-]+", slug):
+ raise HTTPException(status_code=404, detail="Post not found")
+ # Keep published URLs stable when an admin changes the title.
+ article = validated_article(payload, slug)
+ client = get_supabase()
+ if client is not None:
+ try:
+ response = client.table(articles_table()).update(article).eq("slug", slug).execute()
+ except Exception as exc:
+ raise HTTPException(status_code=502, detail="The article could not be updated. Please try again.") from exc
+ if not response.data:
+ raise HTTPException(status_code=404, detail="Post not found")
+ return response.data[0]
+
+ with POSTS_LOCK:
+ records = json.loads(POSTS_PATH.read_text(encoding="utf-8"))
+ for index, existing in enumerate(records):
+ if existing["slug"] == slug:
+ records[index] = {**existing, **article}
+ save_local_posts(records)
+ return records[index]
+ raise HTTPException(status_code=404, detail="Post not found")
+
+
+@app.delete("/api/posts/{slug}")
+def delete_post(slug: str, _: None = Depends(require_admin)) -> dict[str, bool]:
+ if not re.fullmatch(r"[a-z0-9-]+", slug):
+ raise HTTPException(status_code=404, detail="Post not found")
+ client = get_supabase()
+ if client is not None:
+ try:
+ response = client.table(articles_table()).delete().eq("slug", slug).execute()
+ except Exception as exc:
+ raise HTTPException(status_code=502, detail="The article could not be deleted. Please try again.") from exc
+ if not response.data:
+ raise HTTPException(status_code=404, detail="Post not found")
+ return {"deleted": True}
+
+ with POSTS_LOCK:
+ records = json.loads(POSTS_PATH.read_text(encoding="utf-8"))
+ remaining = [post for post in records if post["slug"] != slug]
+ if len(remaining) == len(records):
+ raise HTTPException(status_code=404, detail="Post not found")
+ save_local_posts(remaining)
+ return {"deleted": True}
+
+
@app.get("/api/posts/{slug}")
def post_by_slug(slug: str) -> dict[str, Any]:
if not re.fullmatch(r"[a-z0-9-]+", slug):
@@ -427,19 +505,11 @@ def post_by_slug(slug: str) -> dict[str, Any]:
client = get_supabase()
if client is not None:
- try:
- response = (
- client.table(articles_table())
- .select("slug,title,excerpt,published_at,read_time,tags,accent,content,banner,attachments")
- .eq("slug", slug)
- .limit(1)
- .execute()
- )
- except Exception as exc:
- raise HTTPException(
- status_code=status.HTTP_502_BAD_GATEWAY,
- detail="The journal store is temporarily unavailable.",
- ) from exc
+ response = read_article_query(
+ client.table(articles_table())
+ .select("slug,title,excerpt,published_at,read_time,tags,accent,content,banner,attachments")
+ .eq("slug", slug).limit(1)
+ )
if response.data:
return response.data[0]
raise HTTPException(status_code=404, detail="Post not found")
diff --git a/backend/requirements.txt b/backend/requirements.txt
index a064abb..fd552e3 100644
--- a/backend/requirements.txt
+++ b/backend/requirements.txt
@@ -1,4 +1,5 @@
fastapi
+httpx
Pillow
uvicorn[standard]
email-validator
diff --git a/backend/test_articles.py b/backend/test_articles.py
index 53803f7..d526cf4 100644
--- a/backend/test_articles.py
+++ b/backend/test_articles.py
@@ -4,10 +4,12 @@ import os
from pathlib import Path
from tempfile import TemporaryDirectory
import unittest
-from unittest.mock import patch
+from unittest.mock import MagicMock, patch
from fastapi.testclient import TestClient
from PIL import Image
+from httpx import ReadTimeout, RemoteProtocolError
+from supabase import PostgrestAPIError
from backend import main
@@ -79,6 +81,99 @@ class ArticleMediaTests(unittest.TestCase):
self.assertEqual(downloaded.headers["x-content-type-options"], "nosniff")
self.assertIn("attachment", downloaded.headers["content-disposition"])
+ def article_payload(self):
+ return {
+ "title": "An editable article", "excerpt": "An introduction with enough detail for readers.",
+ "published_at": "2026-09-12", "read_time": 3, "tags": ["Custom topic"],
+ "content": {"type": "doc", "content": [{"type": "paragraph", "content": [
+ {"type": "text", "text": "An original article body with enough text to validate and publish."}
+ ]}]},
+ }
+
+ def test_admin_role_and_protected_crud(self):
+ self.assertEqual(self.client.post("/api/auth/login", json={"password": "wrong"}).status_code, 401)
+ session = self.client.get("/api/auth/session", headers=self.headers)
+ self.assertEqual(session.json(), {"authenticated": True, "role": "admin"})
+ payload = self.article_payload()
+ self.assertEqual(self.client.post("/api/posts", json=payload).status_code, 401)
+ created = self.client.post("/api/posts", json=payload, headers=self.headers).json()
+ path = f'/api/posts/{created["slug"]}'
+ for headers in ({}, {"Authorization": "Bearer 1.invalid"}):
+ self.assertEqual(self.client.put(path, json=payload, headers=headers).status_code, 401)
+ self.assertEqual(self.client.delete(path, headers=headers).status_code, 401)
+ self.assertEqual(self.client.get(path).json()["title"], payload["title"])
+
+ payload["title"] = "The updated article title"
+ payload["tags"] = ["Updated topic"]
+ payload["attachments"] = [self.upload(b"updated notes", name="notes.txt").json()]
+ updated = self.client.put(path, json=payload, headers=self.headers)
+ self.assertEqual(updated.status_code, 200, updated.text)
+ self.assertEqual(updated.json()["slug"], created["slug"])
+ self.assertEqual(self.client.get(path).json()["attachments"], payload["attachments"])
+ self.assertEqual(self.client.get("/api/posts").json()[0]["title"], payload["title"])
+ invalid = {**payload, "content": {"type": "doc", "content": []}}
+ self.assertEqual(self.client.put(path, json=invalid, headers=self.headers).status_code, 422)
+ self.assertEqual(self.client.put("/api/posts/missing", json=payload, headers=self.headers).status_code, 404)
+ self.assertEqual(self.client.delete(path, headers=self.headers).status_code, 200)
+ self.assertEqual(self.client.get(path).status_code, 404)
+ self.assertEqual(self.client.get("/api/posts").json(), [])
+ self.assertEqual(json.loads(main.POSTS_PATH.read_text()), [])
+ self.assertEqual(self.client.delete(path, headers=self.headers).status_code, 404)
+
+ def test_supabase_update_delete_are_scoped_and_report_failures(self):
+ client = MagicMock()
+ table = client.table.return_value
+ payload = self.article_payload()
+ table.update.return_value.eq.return_value.execute.return_value.data = [{**payload, "slug": "original-url"}]
+ table.delete.return_value.eq.return_value.execute.return_value.data = [{"slug": "original-url"}]
+ with patch.object(main, "get_supabase", return_value=client):
+ updated = self.client.put("/api/posts/original-url", json=payload, headers=self.headers)
+ self.assertEqual(updated.status_code, 200)
+ table.update.return_value.eq.assert_called_once_with("slug", "original-url")
+ self.assertEqual(self.client.delete("/api/posts/original-url", headers=self.headers).status_code, 200)
+ table.delete.return_value.eq.assert_called_once_with("slug", "original-url")
+ table.update.return_value.eq.return_value.execute.return_value.data = []
+ self.assertEqual(self.client.put("/api/posts/missing", json=payload, headers=self.headers).status_code, 404)
+ table.delete.return_value.eq.return_value.execute.return_value.data = []
+ self.assertEqual(self.client.delete("/api/posts/missing", headers=self.headers).status_code, 404)
+ table.update.return_value.eq.return_value.execute.side_effect = RuntimeError("offline")
+ self.assertEqual(self.client.put("/api/posts/original-url", json=payload, headers=self.headers).status_code, 502)
+ table.delete.return_value.eq.return_value.execute.side_effect = RuntimeError("offline")
+ self.assertEqual(self.client.delete("/api/posts/original-url", headers=self.headers).status_code, 502)
+
+ def test_journal_reads_retry_transient_errors_but_remain_public(self):
+ client = MagicMock()
+ query = MagicMock()
+ query.retry.return_value = query
+ client.table.return_value.select.return_value.order.return_value = query
+ client.table.return_value.select.return_value.eq.return_value.limit.return_value = query
+ article = {**self.article_payload(), "slug": "test-article", "accent": "mint"}
+ response = MagicMock(data=[article])
+ with patch.object(main, "get_supabase", return_value=client), patch.object(main.time, "sleep"):
+ for path in ("/api/posts", "/api/posts/test-article"):
+ for failure in (
+ RemoteProtocolError("connection ended"),
+ ReadTimeout("read timed out"),
+ PostgrestAPIError({"code": "503", "message": "unavailable"}),
+ ):
+ query.execute.reset_mock()
+ query.execute.side_effect = [failure, response]
+ result = self.client.get(path) # No admin token: reading stays public.
+ self.assertEqual(result.status_code, 200, result.text)
+ self.assertEqual(query.execute.call_count, 2)
+ query.execute.reset_mock()
+ query.execute.side_effect = ReadTimeout("offline")
+ self.assertEqual(self.client.get(path).status_code, 502)
+ self.assertEqual(query.execute.call_count, 2)
+ query.execute.reset_mock()
+ query.execute.side_effect = PostgrestAPIError({"code": "42P01", "message": "missing table"})
+ self.assertEqual(self.client.get(path).status_code, 502)
+ self.assertEqual(query.execute.call_count, 1)
+ query.execute.side_effect = None
+ query.execute.return_value = MagicMock(data=[])
+ self.assertEqual(self.client.get("/api/posts").json(), [])
+ self.assertEqual(self.client.get("/api/posts/missing").status_code, 404)
+
if __name__ == "__main__":
unittest.main()
diff --git a/frontend/index.html b/frontend/index.html
index a49f35a..5969a4a 100644
--- a/frontend/index.html
+++ b/frontend/index.html
@@ -11,7 +11,9 @@
-
+
+
+
Alex Herlan — Software Engineer
diff --git a/frontend/public/alex-avatar-96.webp b/frontend/public/alex-avatar-96.webp
new file mode 100644
index 0000000..3678242
Binary files /dev/null and b/frontend/public/alex-avatar-96.webp differ
diff --git a/frontend/public/alex_music.jpg b/frontend/public/alex_music.jpg
new file mode 100644
index 0000000..3ff8166
Binary files /dev/null and b/frontend/public/alex_music.jpg differ
diff --git a/frontend/public/apple-touch-icon.png b/frontend/public/apple-touch-icon.png
new file mode 100644
index 0000000..4b66fc6
Binary files /dev/null and b/frontend/public/apple-touch-icon.png differ
diff --git a/frontend/public/favicon-32.png b/frontend/public/favicon-32.png
new file mode 100644
index 0000000..c2ee15f
Binary files /dev/null and b/frontend/public/favicon-32.png differ
diff --git a/frontend/public/favicon.ico b/frontend/public/favicon.ico
new file mode 100644
index 0000000..9d04a55
Binary files /dev/null and b/frontend/public/favicon.ico differ
diff --git a/frontend/src/App.jsx b/frontend/src/App.jsx
index 69dadc5..f3be765 100644
--- a/frontend/src/App.jsx
+++ b/frontend/src/App.jsx
@@ -2,6 +2,7 @@ import { lazy, Suspense, useEffect, useState } from "react";
import { Route, Routes, useLocation } from "react-router-dom";
import { getProfile } from "./api";
import Layout from "./components/Layout";
+import AdminProvider from "./components/AdminSession";
import AboutPage from "./pages/AboutPage";
import BlogPage from "./pages/BlogPage";
import ContactPage from "./pages/ContactPage";
@@ -38,7 +39,7 @@ export default function App() {
}, []);
return (
-
+
}>
@@ -50,6 +51,7 @@ export default function App() {
} />
} />
} />
+ } />
} />
} />
-
+
);
}
diff --git a/frontend/src/api.js b/frontend/src/api.js
index 8b92874..27f6e87 100644
--- a/frontend/src/api.js
+++ b/frontend/src/api.js
@@ -1,48 +1,112 @@
const API_BASE = import.meta.env.VITE_API_BASE_URL ?? "";
-async function request(path, options = {}) {
- const response = await fetch(`${API_BASE}${path}`, {
- ...options,
- headers: {
- "Content-Type": options.body instanceof File ? "application/octet-stream" : "application/json",
- ...options.headers,
- },
- });
+function reportExpiredSession(token) {
+ window.dispatchEvent(new CustomEvent("journal-session-expired", { detail: { token } }));
+}
- if (!response.ok) {
- let detail = "Something went wrong. Please try again.";
- try {
- const body = await response.json();
- detail = typeof body.detail === "string" ? body.detail : detail;
- } catch {
- // Keep the friendly fallback when a proxy or server returns non-JSON.
+async function request(path, { timeoutMs = 0, ...options } = {}) {
+ const controller = new AbortController();
+ const abort = () => controller.abort();
+ if (options.signal?.aborted) controller.abort();
+ options.signal?.addEventListener("abort", abort, { once: true });
+ const timer = timeoutMs ? setTimeout(abort, timeoutMs) : null;
+ try {
+ const response = await fetch(`${API_BASE}${path}`, {
+ ...options,
+ signal: controller.signal,
+ headers: { "Content-Type": "application/json", ...options.headers },
+ });
+ if (!response.ok) {
+ if (response.status === 401 && options.headers?.Authorization) {
+ reportExpiredSession(options.headers.Authorization.replace(/^Bearer /, ""));
+ }
+ let detail = "Something went wrong. Please try again.";
+ try {
+ const body = await response.json();
+ if (typeof body.detail === "string") detail = body.detail;
+ } catch { /* Keep the fallback for proxy errors. */ }
+ const error = new Error(detail);
+ error.status = response.status;
+ throw error;
+ }
+ return await response.json();
+ } catch (error) {
+ if (controller.signal.aborted && !options.signal?.aborted) {
+ const timeout = new Error("The request took too long. Please try again.");
+ timeout.status = 408;
+ throw timeout;
}
- const error = new Error(detail);
- error.status = response.status;
throw error;
+ } finally {
+ if (timer !== null) clearTimeout(timer);
+ options.signal?.removeEventListener("abort", abort);
}
+}
- return response.json();
+function retryDelay(signal) {
+ return new Promise((resolve, reject) => {
+ const abort = () => { clearTimeout(timer); reject(new DOMException("Canceled", "AbortError")); };
+ const timer = setTimeout(() => { signal?.removeEventListener("abort", abort); resolve(); }, 400);
+ if (signal?.aborted) abort();
+ else signal?.addEventListener("abort", abort, { once: true });
+ });
+}
+
+async function readRequest(path, options = {}) {
+ for (let attempt = 0; attempt < 2; attempt += 1) {
+ try { return await request(path, { timeoutMs: 20000, ...options }); }
+ catch (error) {
+ const temporary = error instanceof TypeError || error.status === 408 || error.status >= 500;
+ if (options.signal?.aborted || !temporary || attempt === 1) throw error;
+ await retryDelay(options.signal);
+ }
+ }
}
export const getProfile = (signal) => request("/api/profile", { signal });
export const getExperience = (signal) => request("/api/experience", { signal });
export const getSkills = (signal) => request("/api/skills", { signal });
-export const getPosts = (signal) => request("/api/posts", { signal });
-export const getPost = (slug, signal) => request(`/api/posts/${slug}`, { signal });
+export const getPosts = (signal) => readRequest("/api/posts", { signal });
+export const getPost = (slug, signal) => readRequest(`/api/posts/${slug}`, { signal });
export const mediaUrl = (media) => `${API_BASE}${media.url}`;
-export const uploadMedia = (file, purpose, token) => request(`/api/uploads?name=${encodeURIComponent(file.name)}&purpose=${purpose}`, {
- method: "POST",
- headers: { Authorization: `Bearer ${token}` },
- body: file,
-});
+export function uploadMedia(file, purpose, token, { onProgress, signal } = {}) {
+ return new Promise((resolve, reject) => {
+ const xhr = new XMLHttpRequest();
+ const abort = () => xhr.abort();
+ if (signal?.aborted) { reject(new DOMException("Upload canceled", "AbortError")); return; }
+ xhr.open("POST", `${API_BASE}/api/uploads?name=${encodeURIComponent(file.name)}&purpose=${purpose}`);
+ xhr.setRequestHeader("Authorization", `Bearer ${token}`);
+ xhr.setRequestHeader("Content-Type", "application/octet-stream");
+ xhr.responseType = "json";
+ xhr.timeout = 120000;
+ xhr.upload.onprogress = (event) => {
+ if (event.lengthComputable) onProgress?.(Math.round(event.loaded / event.total * 100));
+ };
+ xhr.onload = () => {
+ if (xhr.status >= 200 && xhr.status < 300 && xhr.response) resolve(xhr.response);
+ else {
+ if (xhr.status === 401) reportExpiredSession(token);
+ const error = new Error(typeof xhr.response?.detail === "string" ? xhr.response.detail : "Upload failed. Please try again.");
+ error.status = xhr.status;
+ reject(error);
+ }
+ };
+ xhr.onerror = () => reject(new Error("Connection lost. Check your connection and retry."));
+ xhr.ontimeout = () => reject(new Error("Upload timed out. Please retry."));
+ xhr.onabort = () => reject(new DOMException("Upload canceled", "AbortError"));
+ xhr.onloadend = () => signal?.removeEventListener("abort", abort);
+ signal?.addEventListener("abort", abort, { once: true });
+ xhr.send(file);
+ });
+}
export const loginAdmin = (password) =>
request("/api/auth/login", {
method: "POST",
body: JSON.stringify({ password }),
});
export const getAdminSession = (token, signal) =>
- request("/api/auth/session", {
+ readRequest("/api/auth/session", {
+ timeoutMs: 5000,
signal,
headers: { Authorization: `Bearer ${token}` },
});
@@ -52,6 +116,15 @@ export const createPost = (payload, token) =>
headers: { Authorization: `Bearer ${token}` },
body: JSON.stringify(payload),
});
+export const updateArticle = (slug, payload, token) => request(`/api/posts/${slug}`, {
+ method: "PUT",
+ headers: { Authorization: `Bearer ${token}` },
+ body: JSON.stringify(payload),
+});
+export const deleteArticle = (slug, token) => request(`/api/posts/${slug}`, {
+ method: "DELETE",
+ headers: { Authorization: `Bearer ${token}` },
+});
export const sendContactMessage = (payload) =>
request("/api/contact", {
method: "POST",
diff --git a/frontend/src/articleContent.js b/frontend/src/articleContent.js
new file mode 100644
index 0000000..f5ea1ea
--- /dev/null
+++ b/frontend/src/articleContent.js
@@ -0,0 +1,13 @@
+// Starter articles use section arrays; the editor uses Tiptap documents.
+export function editableDocument(content) {
+ if (!Array.isArray(content)) return content;
+ return { type: "doc", content: content.flatMap((section) => [
+ ...(section.heading ? [{ type: "heading", attrs: { level: 2 }, content: [{ type: "text", text: section.heading }] }] : []),
+ ...section.paragraphs.map((text) => ({ type: "paragraph", ...(text ? { content: [{ type: "text", text }] } : {}) })),
+ ]) };
+}
+
+export function articlePlainText(node) {
+ if (!node) return "";
+ return [node.text ?? "", ...(node.content ?? []).map(articlePlainText)].filter(Boolean).join(" ").trim();
+}
diff --git a/frontend/src/components/AdminSession.jsx b/frontend/src/components/AdminSession.jsx
new file mode 100644
index 0000000..77758a2
--- /dev/null
+++ b/frontend/src/components/AdminSession.jsx
@@ -0,0 +1,128 @@
+import { createContext, useCallback, useContext, useEffect, useRef, useState } from "react";
+import { Link } from "react-router-dom";
+import { getAdminSession, loginAdmin } from "../api";
+import Modal from "./Modal";
+import Icon from "./Icon";
+
+const TOKEN_KEY = "alex-journal-admin";
+const AdminContext = createContext(null);
+export const useAdmin = () => useContext(AdminContext);
+
+export default function AdminProvider({ children }) {
+ const [token, setToken] = useState(() => sessionStorage.getItem(TOKEN_KEY) ?? "");
+ const [checking, setChecking] = useState(Boolean(token));
+ const [role, setRole] = useState(null);
+ const [open, setOpen] = useState(false);
+ const [password, setPassword] = useState("");
+ const [busy, setBusy] = useState(false);
+ const [error, setError] = useState("");
+ const [sessionRevision, setSessionRevision] = useState(0);
+ const [checkAttempt, setCheckAttempt] = useState(0);
+ const tokenRef = useRef(token);
+ const verifiedToken = useRef("");
+
+ const signOut = useCallback(() => {
+ tokenRef.current = "";
+ verifiedToken.current = "";
+ sessionStorage.removeItem(TOKEN_KEY);
+ setToken("");
+ setRole(null);
+ setChecking(false);
+ setPassword("");
+ setOpen(false);
+ }, []);
+
+ useEffect(() => {
+ if (!token || verifiedToken.current === token) return;
+ const controller = new AbortController();
+ setChecking(true);
+ getAdminSession(token, controller.signal)
+ .then((session) => {
+ if (!controller.signal.aborted && tokenRef.current === token) {
+ verifiedToken.current = token;
+ setRole(session.role);
+ setError("");
+ setSessionRevision((current) => current + 1);
+ }
+ })
+ .catch((requestError) => {
+ if (!controller.signal.aborted && tokenRef.current === token) {
+ if (requestError.status === 401) signOut();
+ setError(requestError.status === 401 ? requestError.message : "Could not check your session. Retry when your connection is back, or sign in again.");
+ }
+ })
+ .finally(() => { if (!controller.signal.aborted) setChecking(false); });
+ return () => controller.abort();
+ }, [token, checkAttempt, signOut]);
+
+ useEffect(() => {
+ const retry = () => { if (tokenRef.current && !verifiedToken.current) setCheckAttempt((current) => current + 1); };
+ window.addEventListener("online", retry);
+ window.addEventListener("focus", retry);
+ return () => { window.removeEventListener("online", retry); window.removeEventListener("focus", retry); };
+ }, []);
+
+ useEffect(() => {
+ const expire = (event) => {
+ const expiredToken = event?.detail?.token ?? token;
+ if (!expiredToken || expiredToken !== tokenRef.current) return;
+ signOut();
+ setError("Your session ended. Sign in again to manage articles.");
+ };
+ window.addEventListener("journal-session-expired", expire);
+ const expiresAt = Number(token.split(".")[0]) * 1000;
+ const timer = token ? setTimeout(expire, Math.max(0, expiresAt - Date.now())) : null;
+ return () => {
+ window.removeEventListener("journal-session-expired", expire);
+ if (timer !== null) clearTimeout(timer);
+ };
+ }, [token, signOut]);
+
+ async function signIn(event) {
+ event.preventDefault();
+ if (busy) return;
+ setBusy(true);
+ setError("");
+ try {
+ const session = await loginAdmin(password);
+ sessionStorage.setItem(TOKEN_KEY, session.access_token);
+ tokenRef.current = session.access_token;
+ verifiedToken.current = session.access_token;
+ setToken(session.access_token);
+ setRole(session.role);
+ setChecking(false);
+ setSessionRevision((current) => current + 1);
+ setPassword("");
+ setOpen(false);
+ } catch (requestError) {
+ setError(requestError.message);
+ } finally {
+ setBusy(false);
+ }
+ }
+
+ const isAdmin = role === "admin" && Boolean(token) && !checking;
+ const close = () => { setOpen(false); setPassword(""); };
+ return setOpen(true) }}>
+ {children}
+ {open &&
+ {isAdmin ?
+
Admin
+
You can create, edit, and delete journal articles.
+
New article
+
Manage articles
+
+
: }
+ }
+ ;
+}
diff --git a/frontend/src/components/ArticleAdminActions.jsx b/frontend/src/components/ArticleAdminActions.jsx
new file mode 100644
index 0000000..4d3b977
--- /dev/null
+++ b/frontend/src/components/ArticleAdminActions.jsx
@@ -0,0 +1,44 @@
+import { useState } from "react";
+import { Link } from "react-router-dom";
+import { deleteArticle } from "../api";
+import { useAdmin } from "./AdminSession";
+import Icon from "./Icon";
+import Modal from "./Modal";
+
+export default function ArticleAdminActions({ post, onDeleted }) {
+ const { isAdmin, token } = useAdmin();
+ const [confirming, setConfirming] = useState(false);
+ const [busy, setBusy] = useState(false);
+ const [error, setError] = useState("");
+ if (!isAdmin) return null;
+
+ async function remove() {
+ if (busy) return;
+ setBusy(true);
+ setError("");
+ try {
+ await deleteArticle(post.slug, token);
+ setConfirming(false);
+ onDeleted(post.slug);
+ } catch (requestError) {
+ setError(requestError.message);
+ } finally {
+ setBusy(false);
+ }
+ }
+
+ return
+
Edit
+
+ {confirming &&
setConfirming(false)} busy={busy}>
+ “{post.title}” will be removed from the journal. This cannot be undone.
+ {error && {error}
}
+
+
+
+
+ }
+
;
+}
diff --git a/frontend/src/components/ArticleUploads.jsx b/frontend/src/components/ArticleUploads.jsx
index 247223e..0970662 100644
--- a/frontend/src/components/ArticleUploads.jsx
+++ b/frontend/src/components/ArticleUploads.jsx
@@ -1,40 +1,184 @@
+import { useEffect, useId, useRef, useState } from "react";
import { mediaUrl } from "../api";
+import Icon from "./Icon";
-export default function ArticleUploads({ banner, attachments, busy, onUpload, onRemoveBanner, onRemoveAttachment }) {
- return (
-
@@ -293,13 +271,15 @@ export default function JournalAdminPage() {
Use + Section to add a heading and a new section. Each section gets a divider and an automatic uppercase drop cap on its opening paragraph.
- setBanner(null)}
+ setBanner(null)}
onRemoveAttachment={(url) => setAttachments((current) => current.filter((file) => file.url !== url))} />
-
diff --git a/frontend/src/styles.css b/frontend/src/styles.css
index e646e26..e82f84a 100644
--- a/frontend/src/styles.css
+++ b/frontend/src/styles.css
@@ -189,7 +189,6 @@ button {
.nav-link:hover {
color: var(--ink);
- transform: translateY(-1px);
}
.nav-link.is-active {
@@ -1078,6 +1077,21 @@ button {
background: rgba(255, 255, 255, 0.72);
}
+.journal-filters { flex: 1; min-width: 0; }
+.journal-tools:has(.journal-filters) { align-items: flex-start; }
+.filter-row--wrap { flex-wrap: wrap; overflow: visible; }
+.filter-row--wrap button { max-width: 100%; overflow-wrap: anywhere; }
+.filter-row .others-filter { display: inline-flex; align-items: center; gap: 5px; border: 1px solid var(--line); }
+.others-filter svg { flex-shrink: 0; transition: transform 150ms ease; }
+.others-filter[aria-expanded="true"] svg { transform: rotate(180deg); }
+.custom-topic-filters { margin-top: 12px; padding: 15px; border: 1px solid var(--line); border-radius: 16px; background: rgba(255, 255, 255, 0.45); }
+.custom-topic-filters[hidden] { display: none; }
+.custom-topic-filters > p { display: flex; align-items: center; gap: 8px; margin: 0 0 10px; color: var(--ink-soft); font-size: 11px; font-weight: 650; }
+.custom-topic-filters > p span { padding: 2px 7px; border-radius: 10px; background: var(--mint); font-size: 10px; }
+.custom-topic-filters > small { color: var(--ink-soft); font-size: 11px; }
+.custom-topic-filters .filter-row button { background: var(--surface); }
+.custom-topic-filters .filter-row button.is-active { color: white; background: var(--sage-deep); }
+
.posts-grid {
display: grid;
grid-template-columns: repeat(3, 1fr);
@@ -1750,7 +1764,7 @@ button {
.culture-intro {
display: grid;
- grid-template-columns: minmax(240px, 0.8fr) minmax(320px, 1.2fr);
+ grid-template-columns: minmax(0, 0.8fr) minmax(0, 1.2fr);
align-items: end;
gap: 8px 48px;
margin-bottom: 28px;
@@ -2057,6 +2071,32 @@ button {
box-shadow: 0 8px 19px rgba(47, 81, 71, 0.15);
}
+.topic-chip {
+ display: inline-flex;
+ align-items: center;
+ gap: 5px;
+ min-height: 38px;
+ max-width: 100%;
+ padding-left: 13px;
+ border-radius: 12px;
+ color: white;
+ background: var(--sage-deep);
+ font-size: 12px;
+ font-weight: 680;
+ box-shadow: 0 8px 19px rgba(47, 81, 71, 0.15);
+}
+.topic-chip > span { display: inline-flex; align-items: center; gap: 5px; min-width: 0; overflow-wrap: anywhere; }
+.topic-chip > span svg { flex-shrink: 0; }
+.topic-options .topic-chip__remove { display: grid; place-items: center; flex-shrink: 0; width: 36px; padding: 0; color: white; background: transparent; }
+.topic-options .topic-chip__remove:hover { background: rgba(255, 255, 255, 0.16); }
+.topic-options .topic-chip__remove:focus-visible { outline: 2px solid var(--sage-deep); outline-offset: 3px; }
+.custom-topic__input { position: relative; display: flex; flex: 1; min-width: 0; }
+.custom-topic__input input { width: 100%; padding-right: 82px; }
+.custom-topic__input > kbd { position: absolute; right: 10px; top: 50%; transform: translateY(-50%); pointer-events: none; }
+.topic-picker kbd { padding: 3px 6px; border: 1px solid var(--line); border-bottom-width: 2px; border-radius: 6px; color: var(--ink-soft); background: #f0f3ef; font: 10px ui-monospace, monospace; white-space: nowrap; }
+.topic-hint, .topic-feedback { margin: 0; font-size: 11px; line-height: 1.8; color: var(--ink-soft); }
+.topic-feedback { color: var(--sage-deep); }
+
.custom-topic {
display: flex;
max-width: 430px;
@@ -2075,6 +2115,7 @@ button {
background: #fbfcfa;
font-size: 14px;
}
+.custom-topic .custom-topic__input input { padding-right: 82px; }
.custom-topic input:focus {
border-color: rgba(47, 81, 71, 0.43);
@@ -2715,37 +2756,229 @@ button {
height: 100%;
object-fit: cover;
}
-.article-hero:has(.article-banner) { padding-top: 0; }
+.article-hero:has(.article-banner) {
+ isolation: isolate;
+ color: #fff;
+}
.article-banner {
display: block;
+ position: absolute;
+ inset: 0;
width: 100%;
- height: clamp(220px, 38vw, 500px);
+ height: 100%;
object-fit: cover;
- margin-bottom: clamp(36px, 6vw, 72px);
+ z-index: -2;
+}
+.article-hero:has(.article-banner)::before {
+ content: "";
+ position: absolute;
+ inset: 0;
+ background: linear-gradient(110deg, rgba(15, 29, 24, 0.82), rgba(15, 29, 24, 0.58));
+ z-index: -1;
+ pointer-events: none;
+}
+.article-hero:has(.article-banner) .article-container {
position: relative;
z-index: 1;
}
+.article-hero:has(.article-banner) .article-container > p,
+.article-hero:has(.article-banner) .article-byline,
+.article-hero:has(.article-banner) .article-byline--simple span + span::before {
+ color: rgba(255, 255, 255, 0.9);
+}
+.article-hero:has(.article-banner) .article-tags span {
+ color: #fff;
+ background: rgba(255, 255, 255, 0.16);
+ border-color: rgba(255, 255, 255, 0.3);
+}
.article-hero:has(.article-banner) .article-hero__shape { display: none; }
.article-uploads {
display: grid;
- gap: 24px;
+ grid-column: 1 / -1;
+ gap: 30px;
min-width: 0;
- padding: 24px;
+ margin: 0;
+ padding: clamp(18px, 3vw, 30px);
border: 1px solid var(--line);
- border-radius: 18px;
+ border-radius: 22px;
+ background: rgba(255, 255, 255, 0.45);
}
-.article-uploads legend { padding-inline: 8px; }
+.article-uploads legend { padding-inline: 10px; font-size: 16px; }
+.section-help { grid-column: 1 / -1; }
.article-uploads small, .section-help { color: var(--ink-soft); line-height: 1.6; }
-.article-uploads input[type="file"] { max-width: 100%; padding: 12px 0; }
-.upload-preview { display: grid; gap: 12px; justify-items: start; overflow-wrap: anywhere; }
-.upload-preview img { width: 100%; max-height: 240px; object-fit: cover; border-radius: 12px; }
-.upload-list { display: grid; gap: 12px; list-style: none; margin: 0; padding: 0; }
-.upload-list li { display: flex; align-items: center; gap: 14px; }
-.upload-list li > span { flex: 1; min-width: 0; overflow-wrap: anywhere; }
-.upload-list img { width: 64px; height: 64px; object-fit: cover; border-radius: 8px; }
+.upload-section { display: grid; gap: 14px; min-width: 0; }
+.upload-section + .upload-section { border-top: 1px solid var(--line); padding-top: 28px; }
+.upload-section__heading { display: flex; justify-content: space-between; align-items: flex-start; gap: 12px; }
+.upload-section__heading h3, .upload-queue h3 { margin: 0 0 5px; font-size: 11px; letter-spacing: 0.06em; text-transform: uppercase; }
+.upload-section__heading p { margin: 0; color: var(--ink-soft); font-size: 12px; line-height: 1.6; }
+.upload-label { flex-shrink: 0; padding: 3px 9px; border-radius: 20px; background: var(--mint); color: var(--sage-deep); font-size: 11px; }
+.upload-dropzone {
+ display: grid;
+ justify-items: center;
+ gap: 9px;
+ padding: 26px 18px;
+ border: 1.5px dashed #b7cbc0;
+ border-radius: 17px;
+ background: linear-gradient(135deg, #f2f7f3, #fafcf9);
+ text-align: center;
+ transition: border-color 150ms, background 150ms, box-shadow 150ms;
+}
+.upload-dropzone:hover, .upload-dropzone:focus-within { border-color: var(--sage-deep); }
+.upload-dropzone.is-dragging { border-color: var(--sage-deep); background: var(--mint); box-shadow: inset 0 0 0 2px var(--sage-deep); }
+.upload-dropzone.is-disabled { opacity: 0.6; }
+.upload-dropzone__icon { display: grid; place-items: center; width: 48px; height: 48px; margin-bottom: 4px; border-radius: 16px; background: #e3eee6; color: var(--sage-deep); }
+.upload-dropzone strong { font-size: 15px; font-weight: 600; }
+.upload-dropzone p { margin: 0; color: var(--ink-soft); font-size: 12px; line-height: 1.6; }
+.upload-dropzone small { font-size: 11px; }
+.upload-browse { display: inline-flex; justify-content: center; align-items: center; gap: 7px; min-height: 40px; margin-top: 5px; padding: 9px 15px; border: 1px solid var(--line); border-radius: 11px; background: white; color: var(--sage-deep); font-size: 12px; font-weight: 650; cursor: pointer; }
+.article-uploads .upload-input { display: none; }
+.upload-tip { margin: 0; color: var(--ink-soft); font-size: 11px; line-height: 1.6; }
+.upload-hero-preview { position: relative; isolation: isolate; display: grid; align-items: end; min-height: 220px; overflow: hidden; border-radius: 16px; background: var(--sage-deep); color: white; }
+.upload-hero-preview > img { position: absolute; inset: 0; width: 100%; height: 100%; object-fit: cover; z-index: -2; }
+.upload-hero-preview::before { content: ""; position: absolute; inset: 0; z-index: -1; background: linear-gradient(110deg, rgba(15,29,24,.82), rgba(15,29,24,.58)); }
+.upload-hero-preview > div { display: grid; gap: 12px; padding: 25px; }
+.upload-hero-preview span { font-size: 10px; text-transform: uppercase; letter-spacing: .08em; opacity: .8; }
+.upload-hero-preview strong { font-family: Georgia, serif; font-size: clamp(24px, 3vw, 38px); line-height: 1.1; font-weight: 400; overflow-wrap: anywhere; }
+.upload-hero-preview p { margin: 0; max-width: 500px; font-size: 12px; line-height: 1.6; color: rgba(255,255,255,.9); overflow-wrap: anywhere; }
+.upload-saved-banner { display: flex; align-items: center; justify-content: space-between; gap: 12px; font-size: 12px; }
+.upload-saved-banner > span { min-width: 0; overflow-wrap: anywhere; color: var(--sage-deep); }
+.upload-saved-banner .text-button { flex-shrink: 0; font-size: 11px; }
+.upload-list { display: grid; gap: 10px; list-style: none; margin: 0; padding: 0; }
+.upload-list li { display: flex; align-items: center; gap: 12px; min-width: 0; padding: 12px; border: 1px solid var(--line); border-radius: 14px; background: var(--surface); }
+.upload-file-icon { display: grid; place-items: center; flex: 0 0 42px; width: 42px; height: 46px; border-radius: 9px; overflow: hidden; background: var(--mint); color: var(--sage-deep); }
+.upload-file-icon img { width: 100%; height: 100%; object-fit: cover; }
+.upload-file-info { flex: 1; min-width: 0; display: grid; gap: 3px; overflow-wrap: anywhere; }
+.upload-file-info strong { font-size: 12px; font-weight: 600; }
+.upload-file-info small { font-size: 10px; }
+.upload-ready { color: var(--sage-deep); }
+.upload-file-actions { display: flex; align-items: center; flex-shrink: 0; gap: 2px; }
+.upload-icon-button { display: grid; place-items: center; width: 34px; height: 36px; padding: 0; border: 0; border-radius: 8px; background: transparent; color: var(--ink-soft); cursor: pointer; }
+.upload-icon-button:hover { background: var(--mint); color: var(--sage-deep); }
+.upload-icon-button:disabled { opacity: 0.25; }
+.upload-queue { display: grid; gap: 12px; }
+.upload-file-info progress { width: 100%; height: 6px; margin-top: 4px; accent-color: var(--sage-deep); }
+.upload-file-info p { margin: 0; color: #9a3434; font-size: 11px; line-height: 1.6; }
+.upload-list .has-error { border-color: #d7af9e; background: #fff9f6; }
+.upload-feedback { padding: 16px; border: 1px solid #d7af9e; border-radius: 14px; background: #fff9f6; color: #803f30; font-size: 12px; overflow-wrap: anywhere; }
+.upload-feedback ul { margin: 8px 0 12px; padding-left: 18px; line-height: 1.7; }
+@media (min-width: 900px) {
+ .article-uploads { grid-template-columns: minmax(0, 1fr) minmax(0, 1fr); align-items: start; }
+ .upload-section + .upload-section { border-top: 0; border-left: 1px solid var(--line); padding-top: 0; padding-left: 28px; }
+ .upload-feedback, .upload-queue { grid-column: 1 / -1; }
+}
+@media (max-width: 480px) {
+ .upload-list li { flex-wrap: wrap; gap: 8px; }
+ .upload-file-actions { margin-left: auto; }
+ .upload-file-info { flex-basis: calc(100% - 54px); }
+ .upload-icon-button { width: 40px; height: 40px; }
+ .upload-saved-banner { align-items: flex-start; }
+}
.article-attachments { margin-top: 55px; padding-top: 48px; border-top: 1px solid var(--line); }
.article-attachments figure { margin: 24px 0; }
.article-attachments img { display: block; max-width: 100%; height: auto; margin-inline: auto; border-radius: 12px; }
.article-attachments figcaption { margin-top: 10px; color: var(--ink-soft); font-size: 14px; overflow-wrap: anywhere; }
.article-file { display: flex; flex-wrap: wrap; justify-content: space-between; gap: 12px; padding: 20px; margin-block: 12px; background: var(--surface); border: 1px solid var(--line); border-radius: 12px; overflow-wrap: anywhere; }
.article-file small { color: var(--ink-soft); }
+
+.header-actions { display: flex; align-items: center; gap: 12px; }
+.icon-button {
+ display: inline-grid;
+ place-items: center;
+ width: 44px;
+ height: 44px;
+ flex: 0 0 auto;
+ border: 1px solid var(--line);
+ border-radius: 15px;
+ color: var(--ink);
+ background: var(--surface);
+ cursor: pointer;
+}
+.icon-button:hover { background: var(--mint); }
+.header-signin { position: relative; }
+.header-signin.is-admin { color: #fff; background: var(--sage-deep); }
+.admin-indicator { position: absolute; right: 3px; top: 3px; width: 8px; height: 8px; border-radius: 50%; background: #bde9a8; }
+.admin-dialog {
+ width: min(460px, calc(100vw - 32px));
+ max-height: calc(100dvh - 40px);
+ overflow: auto;
+ padding: 28px;
+ border: 1px solid var(--line);
+ border-radius: 24px;
+ color: var(--ink);
+ background: var(--paper);
+ box-shadow: var(--shadow);
+ font-family: Roboto, ui-sans-serif, sans-serif;
+ font-size: 15px;
+ line-height: 1.6;
+ text-align: left;
+}
+.admin-dialog::backdrop { background: rgba(15, 29, 24, 0.5); backdrop-filter: blur(5px); }
+.admin-dialog__heading { display: flex; align-items: center; justify-content: space-between; gap: 16px; margin-bottom: 20px; }
+.admin-dialog .admin-dialog__heading h2 { margin: 0; font-family: Georgia, serif; font-size: 28px; font-weight: 400; line-height: 1.2; }
+.admin-signin, .admin-account { display: grid; gap: 20px; }
+.admin-signin p, .admin-account p { margin: 0; }
+.admin-signin .publisher-field { margin: 0; }
+.dialog-actions { display: flex; justify-content: flex-end; flex-wrap: wrap; gap: 12px; margin-top: 24px; }
+.article-admin-actions { display: flex; flex-wrap: wrap; align-items: center; gap: 20px; }
+.post-card:has(.article-admin-actions) { display: flex; flex-direction: column; }
+.post-card:has(.article-admin-actions) > a { height: auto; flex: 1; }
+.post-card > .article-admin-actions { padding: 16px 24px; border-top: 1px solid var(--line); }
+.article-hero .article-admin-actions { width: fit-content; padding: 10px 18px; border-radius: 12px; background: var(--paper); color: var(--ink); margin: -16px 0 28px; }
+.text-button--danger { color: #9a3434; }
+.button--danger { color: #fff; background: #9a3434; border-color: #9a3434; }
+.button--danger:hover { background: #7e2929; }
+button:disabled { cursor: not-allowed; opacity: 0.6; }
+@media (max-width: 600px) {
+ .header-actions { gap: 8px; }
+ .admin-dialog { padding: 22px; }
+}
+
+.brand-photo { display: block; flex-shrink: 0; border-radius: 50%; object-fit: cover; background: transparent; }
+.culture-card--wide { display: grid; grid-template-columns: 206px minmax(0, 1fr); align-items: center; gap: clamp(24px, 3vw, 40px); }
+.culture-photo { display: block; width: 100%; max-width: 206px; height: auto; aspect-ratio: 1; object-fit: cover; border-radius: 22px; box-shadow: 0 14px 30px rgba(35, 30, 45, 0.18); }
+.culture-content { min-width: 0; }
+@media (max-width: 1000px) {
+ .culture-card--wide { grid-template-columns: 170px minmax(0, 1fr); gap: 26px; }
+ .culture-content .culture-intro { grid-template-columns: 1fr; gap: 12px; }
+ .culture-content .culture-links { grid-template-columns: 1fr; }
+}
+@media (max-width: 520px) {
+ .culture-card--wide { grid-template-columns: 1fr; }
+ .culture-photo { width: 180px; max-width: 100%; }
+}
+
+/* Motion feedback is reserved for large action buttons and interest cards. */
+:is(.button, .culture-link) {
+ -webkit-tap-highlight-color: transparent;
+ touch-action: manipulation;
+ transition: translate 160ms ease, scale 120ms ease, background-color 160ms ease, color 160ms ease, box-shadow 160ms ease, filter 160ms ease;
+}
+:is(button, .button, .nav-link, .culture-link, .brand, .write-link, .social-list a):focus-visible {
+ outline: 3px solid #668979;
+ outline-offset: 4px;
+}
+@media (hover: hover) and (pointer: fine) {
+ :is(.button, .culture-link):not(:disabled):hover {
+ translate: 0 -2px;
+ filter: brightness(1.04);
+ box-shadow: 0 7px 18px rgba(36, 52, 47, 0.14);
+ }
+ .button:hover, .culture-link:hover { transform: none; }
+}
+:is(.button, .culture-link):not(:disabled):active,
+:is(.button, .culture-link)[data-pressed="true"] {
+ translate: 0 1px;
+ scale: 0.97;
+ filter: brightness(0.94);
+ box-shadow: 0 2px 5px rgba(36, 52, 47, 0.12);
+}
+@media (prefers-reduced-motion: reduce) {
+ :is(.button, .culture-link),
+ :is(.button, .culture-link):hover,
+ :is(.button, .culture-link):active,
+ :is(.button, .culture-link)[data-pressed="true"] {
+ translate: none !important;
+ scale: none !important;
+ transition: none !important;
+ }
+}
diff --git a/frontend/src/topics.js b/frontend/src/topics.js
new file mode 100644
index 0000000..16ad251
--- /dev/null
+++ b/frontend/src/topics.js
@@ -0,0 +1,6 @@
+export const mainTopics = [
+ "AI", "React", "FastAPI", "Supabase", "Python", "Cloud",
+ "DevOps", "Product", "Reliability", "Security", "Music", "Life",
+];
+
+export const topicKey = (topic) => topic.trim().toLowerCase();
diff --git a/frontend/src/useJournalResource.js b/frontend/src/useJournalResource.js
new file mode 100644
index 0000000..1f60142
--- /dev/null
+++ b/frontend/src/useJournalResource.js
@@ -0,0 +1,41 @@
+import { useCallback, useEffect, useState } from "react";
+import { getPost, getPosts } from "./api";
+import { useAdmin } from "./components/AdminSession";
+
+// Article reads are public. Sign-in only triggers a fresh read, never gates it.
+export default function useJournalResource(slug = null) {
+ const { sessionRevision } = useAdmin();
+ const [attempt, setAttempt] = useState(0);
+ const [state, setState] = useState({ key: slug, data: null, loading: true, error: "" });
+ const reload = useCallback(() => setAttempt((current) => current + 1), []);
+
+ useEffect(() => {
+ const controller = new AbortController();
+ setState((current) => ({ key: slug, data: current.key === slug ? current.data : null, loading: true, error: "" }));
+ const request = slug === null ? getPosts(controller.signal) : getPost(slug, controller.signal);
+ request.then((data) => {
+ if (!controller.signal.aborted) setState({ key: slug, data, loading: false, error: "" });
+ }).catch((error) => {
+ if (!controller.signal.aborted) setState((current) => ({ ...current, loading: false, error: error.message }));
+ });
+ return () => controller.abort();
+ }, [slug, sessionRevision, attempt]);
+
+ useEffect(() => {
+ if (!state.error) return;
+ const visible = () => { if (document.visibilityState === "visible") reload(); };
+ window.addEventListener("online", reload);
+ window.addEventListener("focus", reload);
+ document.addEventListener("visibilitychange", visible);
+ return () => {
+ window.removeEventListener("online", reload);
+ window.removeEventListener("focus", reload);
+ document.removeEventListener("visibilitychange", visible);
+ };
+ }, [state.error, reload]);
+
+ const setData = useCallback((update) => {
+ setState((current) => ({ ...current, data: typeof update === "function" ? update(current.data) : update }));
+ }, []);
+ return { ...state, loading: state.key !== slug || state.loading, data: state.key === slug ? state.data : null, reload, setData };
+}