templates/web-app-template/README.md
templates/web-app-template/README
Project Bootstrap Template
This repository bootstraps backend/ with Laravel + Backpack for Laravel and frontend/ with Nuxt through a shared setup script.
If root-level AGENTS.md and audio2user.sh files exist, they are copied into both generated folders.
Recommendation
The actual setup logic lives in scripts/init-project.sh. npm and composer are only wrappers so the team can choose whichever entrypoint they prefer.
If you want to use audio2user.sh, you will also want a local text-to-speech playback service. This template expects the /play endpoint provided by playText2Speaker.
Usage
npm run init
or:
composer project:init
The bootstrap is now non-interactive by default:
- Nuxt uses the
minimaltemplate unlessNUXT_TEMPLATEis overridden. - Backpack installs with
--no-interaction. - Nested Git repositories are disabled unless
INIT_GIT_REPOS=1is set. - The frontend package manager defaults to
npmand can be changed withPACKAGE_MANAGER.
Configuration
You can override versions and bootstrap behavior with environment variables:
LARAVEL_VERSION='^12.0' BACKPACK_VERSION='^6.0' NUXT_VERSION='latest' npm run init
NUXT_TEMPLATE=minimal INSTALL_BACKPACK=1 INIT_GIT_REPOS=0 npm run init
PACKAGE_MANAGER=pnpm NUXT_TEMPLATE=minimal npm run init