2. Unzip the Package

• Extract the contents of the downloaded .zip file to a directory on your computer.

4. Build for Production

• Command: Compile and optimize your project for production:

  npm run build
  # or
  yarn run build

• Outcome: All files will be compiled and optimized into the dist folder, ready for deployment. The build process will compile CSS and JavaScript files, copy required packages to both src/assets/libs/ and dist/assets/libs/, and generate optimized production assets.

5. Start Development Server

• Note: For development, you need to run two servers simultaneously:
• Terminal 1 - Start the Vite dev server: Start the project in development mode with hot-reloading:

  npm start
  # or
  yarn start

• Terminal 2 - Start your PHP server: Start the PHP built-in server:

  start http://localhost:8000/src/index.php && php -S localhost:8000 router.php

• Outcome: Your project will run locally with hot-reloading enabled. Open http://localhost:8000/src/index.php in your browser to preview the application. The router.php script ensures that static files (images, CSS, JS, fonts, etc.) are served correctly by the PHP built-in server. The vite.php helper automatically detects if the Vite dev server is running on port 5173. If it can't connect, it will fall back to production mode.