TypeScript/Svelte frontend for the Admin Columns free plugin. All commands run from this directory (admin-columns/src/).

npm install
npm run setup

setup configures three things locally (once per developer, not synced via git):

• A git merge driver that prevents asset conflicts on merge
• assume-unchanged on all compiled assets, so watch-mode rebuilds stay out of your git client
• A post-checkout hook that automatically restores assume-unchanged after every branch switch

npm run dev   # Watch mode: JS + CSS + Tailwind together

npm run build   # Full build (JS, CSS, Tailwind, languages)

Compiled assets are committed to git so all developers (including backend) always have a working build. They are intentionally hidden from your git client during development via assume-unchanged.

To commit updated assets:

npm run release:assets   # Runs production build + unlocks assets in git client
# → stage and commit assets in your git client
npm run release:lock     # Re-hides assets from git client

If your git client blocks a branch switch due to locally modified assets:

npm run release:discard  # Discards watch-built changes, allows branch switching

npm run webfont   # Regenerate the icon font from SVG sources

Translations run as part of npm run build; there is no separate languages script.

The npm scripts are thin wrappers around nps:

npx nps build              # full production build
npx nps build.development  # same as `npm run dev`
npx nps languages          # translations only