Skip to content

README.md

Latest commit

 

History

History
101 lines (76 loc) · 3 KB

README.md

File metadata and controls

101 lines (76 loc) · 3 KB
Raw

DemonZ Development

Public website for DemonZ Development — open source projects, articles, and AI research, deployed at https://demonzdevelopment.online.

Repository layout

.
├── backend/        # Hono API on Cloudflare Workers (TypeScript)
├── frontend/       # Public React 19 + Vite site (TypeScript)
└── admin-frontend/ # Admin React 19 + Vite dashboard (TypeScript)

Quick start

# Backend
cd backend
npm install
npm run dev          # wrangler dev (Workers runtime locally)
npm test             # vitest
npm run typecheck    # tsc --noEmit

# Frontend
cd ../frontend
npm install
npm run dev          # Vite dev server with /api proxy
npm test
npm run lint
npm run build

Environment

Backend (backend/.dev.vars or via wrangler secret put)

Name Description
SUPABASE_URL Supabase project URL (e.g. https://xxx.supabase.co)
SUPABASE_SERVICE_KEY Service role key (NEVER expose to the client)
ADMIN_PASSWORD_HASH SHA-256 hex of the admin password
JWT_SECRET Random secret used to sign admin JWTs
CORS_ORIGIN Allowed origin (e.g. https://demonzdevelopment.online)
DEV Set to 1 in dev to allow http://localhost:5173 in CORS

Generate a fresh password hash:

cd backend
npm run hash-password -- "your-password"

Frontend (frontend/.env.local)

Name Default Description
VITE_API_URL /api Backend API base URL. Leave unset in dev (Vite proxy handles /api).

Database

The backend expects a Supabase project with the following tables: projects, articles, changelogs, comments, contact_messages.

After applying the schema, run the migration in backend/supabase/migrations/:

psql "$SUPABASE_DB_URL" -f backend/supabase/migrations/0001_increment_downloads.sql

This creates the increment_downloads(text) RPC used by the download endpoint to safely increment counters without a read-modify-write race.

CI

A single GitHub Action runs on push/PR to main:

  • Backend: tsc --noEmit + vitest
  • Frontend: eslint + tsc -b + vitest + vite build

Deployment

  • Public Site (frontend/): Cloudflare Pages
    • Root directory: frontend
    • Build command: npm run build
    • Build output directory: dist
    • Custom Domain: Bind your custom domain (e.g. demonzdevelopment.online) in the Cloudflare Pages settings.
  • Admin Panel (admin-frontend/): Cloudflare Pages (pages.dev Deployment)
    • Root directory: admin-frontend
    • Build command: npm run build
    • Build output directory: dist
    • Domain: Keep the default [project-name].pages.dev for security.
  • Backend API (backend/): Cloudflare Workers
    • Deploy via wrangler deploy from the backend/ directory.
    • Set wrangler secrets using wrangler secret put <SECRET_NAME>.

License

Code in this repository is released under the MIT license unless noted otherwise inside an individual project folder. Trademarks, logos, and game artwork are not covered.