Skip to Content
Build assets

Build frontend assets

Venom uses Vite and Tailwind from the Paymenter project root (not only inside themes/venom/). The root vite.js selects the theme’s vite.config.js when you pass venom.

1. Install JavaScript dependencies

From the Paymenter repository root (where package.json and vite.js live):

npm install

2. Development (optional)

Watch mode for the Venom theme (if configured in your package.json):

npm run dev -- venom

Or follow the scripts your Paymenter fork defines — many setups use:

node vite.js dev venom

Keep this process running while you edit themes/venom/css/ or themes/venom/js/.

3. Production build

From the Paymenter root:

npm run build:venom

This writes hashed assets under public/venom/ (see your public/venom/manifest.json after a successful build).

4. Deploy

Include public/venom/ in deployments so layouts/app.blade.php can load:

  • @vite([...], 'venom') (or equivalent) for the active theme.

If assets 404, confirm:

  • config('settings.theme') is venom.
  • The build ran on the same branch you deploy.
  • Your web root serves public/ as the document root (standard Laravel).

5. Admin / Filament

Paymenter may ship separate admin theme build steps (build:admin). Venom mainly affects the storefront theme; run those only if you changed admin CSS.

Tip: After upgrading Node or dependencies, delete node_modules and reinstall if builds fail.

InstallationConfiguration