mirror of https://github.com/saltbo/zpan.git synced 2026-09-19 01:51:11 +08:00

Files

T

saltboandClaude Opus 4.6 175c52a548 feat: fix CF Pages deployment and update project docs

- Restructure for wrangler Workers mode (main + [assets] + run_worker_first)
- Move wrangler.toml to project root, add nodejs_compat flag
- Move migrations to root, managed by wrangler d1 migrations
- Web builds to root dist/, wrangler bundles worker entry directly
- Update CONTRIBUTING.md with full dev workflow and quality gates
- CLAUDE.md indexes docs instead of duplicating content

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-04-01 11:09:18 -04:00

1.1 KiB

Raw Blame History

CLAUDE.md

Project Overview

ZPan v2 is an open-source, S3-native file hosting platform written in TypeScript. Cloudflare Pages is the primary deployment target, Node.js (Docker) is backup.

Core architecture: clients upload directly to S3-compatible storage via presigned URLs, bypassing server bandwidth.

Key Context

Monorepo: packages/server (Hono API), packages/web (React SPA), packages/shared (types/schemas)
Dual runtime: entry-cloudflare.ts (CF Workers + D1) and entry-node.ts (Node + SQLite)
Tests are co-located: *.test.ts (Node), *.cf-test.ts (CF Workers)
Migrations: drizzle-kit generates SQL → wrangler manages D1 state

Docs Index

CONTRIBUTING.md — setup, commands, quality gates, migration workflow, deployment
docs/architecture.md — system architecture, tech decisions, platform abstraction
V2_ROADMAP.md — product positioning, release plan (v2.0–v2.9)
docs/roadmap/ — per-version technical specs (v2.0.md–v2.9.md)

Commit Convention

Conventional Commits (feat:, fix:, docs:, etc.). PRs target master.