simaocurado/starter-kit-react-no-auth

The skeleton application for the Laravel framework.

Installs: 2

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 0

Forks: 0

Open Issues: 0

Language:TypeScript

Type:project

pkg:composer/simaocurado/starter-kit-react-no-auth

v1.0.5 2026-02-19 16:58 UTC

This package is auto-updated.

Last update: 2026-02-19 16:58:27 UTC


README

An opinionated starter kit for building Laravel + React apps with a strong focus on quality, typing, and consistency.

Requirements

  • PHP 8.5+
  • Node.js 20.19+ or 22.12+ (required by Vite 7)
  • Bun 1.3+
  • Composer
  • SQLite (or another database configured in .env)

Create Project

composer create-project simaocurado/starter-kit-react-no-auth --prefer-dist my-app
cd my-app
composer setup

composer setup runs:

  • PHP dependency installation
  • .env creation/configuration
  • automatic APP_URL setup to http://<directory-slug>.test (from the current folder name)
  • php artisan key:generate
  • migrations
  • bun install
  • bun run build

Development

With Herd (recommended on macOS)

With Herd, the HTTP server already exists (*.test). You only need to run the frontend:

bun run dev

Open the app at http://<directory-slug>.test.

Optional (if you use queues):

php artisan queue:listen --tries=1

Without Herd

Run:

composer dev

This starts Laravel server, queue worker, logs, and Vite together.

Strictness

This starter applies strict defaults:

  • TypeScript with "strict": true in tsconfig.json
  • PHPStan level 7 + bleedingEdge in phpstan.neon
  • Pest type coverage minimum of 100% (composer test:type-coverage)
  • Pest test coverage requirement of 100% in composer test:unit
  • Pint + Rector for formatting and automated refactors
  • Oxlint + Prettier for frontend quality checks

Scripts

  • composer setup
  • composer dev
  • composer lint
  • composer test
  • composer test:type-coverage
  • composer test:unit
  • composer test:types
  • composer test:lint
  • composer configure:app-url
  • composer update:requirements

Notes

  • If bun run build fails with a Vite/crypto.hash error, upgrade Node to 20.19+ or 22.12+.
  • APP_URL is automatically set to http://<directory-slug>.test during setup. Adjust it manually only if you use a different local domain.