Files
Arkie-Library-Frontend/docs/workflow.md
2026-05-20 11:33:43 +08:00

1.2 KiB

Development Workflow

This repo is intentionally simple: make changes, validate locally, then push only when ready.

Start a session

git status --short --branch
git fetch origin main

If working on staging:

git switch terry-staging
git pull --ff-only

If working directly on production deploy branch:

git switch main
git pull --ff-only origin main

Make changes

Use the existing structure:

  • Public pages: src/pages/<PageName>/index.tsx
  • Admin pages: src/pages/admin/<PageName>/index.tsx
  • Shared components: src/components/
  • API helpers/types: src/api.ts
  • Translations/copy: src/i18n.tsx
  • Display helpers: src/utils/

Avoid editing generated dist/ files.

Validate

Run:

npx tsc --noEmit
npm run format:check
npm test
npm run build

For formatting fixes:

npm run format

Commit

Check the diff first:

git diff
git status --short

Use concise commits, for example:

git add <files>
git commit -m "fix: remove unused imports"

Push

Only push when Terry asks.

git push origin main

or for staging:

git push origin terry-staging