스타터 키트

• 소개
• Laravel Breeze
  • 설치
  • Breeze와 Blade
  • Breeze와 Livewire
  • Breeze와 React / Vue
  • Breeze와 Next.js / API
• Laravel Jetstream

소개

새 Laravel 애플리케이션을 빠르게 시작할 수 있도록, Laravel은 인증 기능이 미리 구성된 스타터 키트를 제공합니다. 스타터 키트를 설치하면 사용자 등록·로그인에 필요한 라우트, 컨트롤러, 뷰가 자동으로 생성됩니다.

스타터 키트는 선택 사항입니다. 처음부터 직접 구성하고 싶다면 Laravel을 새로 설치한 뒤 원하는 방식으로 개발해도 무방합니다.

Laravel Breeze

Laravel Breeze는 Laravel의 인증 기능 전체를 가볍고 간결하게 구현한 스타터 키트입니다. 로그인, 회원가입, 비밀번호 재설정, 이메일 인증, 비밀번호 확인 기능을 포함하며, 사용자가 이름·이메일·비밀번호를 수정할 수 있는 프로필 페이지도 기본 제공됩니다.

기본 뷰 레이어는 Blade 템플릿과 Tailwind CSS로 구성되어 있습니다. 프론트엔드 스택으로는 Blade 외에도 Livewire, Inertia(Vue 또는 React)를 선택할 수 있습니다.

Laravel Bootcamp

Laravel을 처음 접한다면 Laravel Bootcamp를 먼저 살펴보세요. Breeze를 활용해 첫 번째 Laravel 애플리케이션을 만드는 과정을 단계별로 안내합니다.

설치

먼저 새 Laravel 애플리케이션을 생성합니다. Laravel 인스톨러를 사용하면 설치 과정 중 Breeze를 바로 선택할 수 있습니다. 이미 스타터 키트 없이 애플리케이션을 생성했다면 아래 방법으로 수동 설치할 수 있습니다.

Composer로 Breeze 패키지를 설치합니다:

composer require laravel/breeze --dev

패키지 설치가 완료되면 breeze:install Artisan 명령을 실행합니다. 이 명령은 인증 관련 뷰, 라우트, 컨트롤러 등 모든 파일을 애플리케이션에 직접 복사합니다. 코드가 프로젝트 안에 완전히 노출되므로 동작 방식을 자유롭게 확인하고 수정할 수 있습니다.

breeze:install 실행 시 원하는 프론트엔드 스택과 테스트 프레임워크를 선택하는 프롬프트가 표시됩니다:

php artisan breeze:installphp artisan migratenpm installnpm run dev

Breeze와 Blade

Breeze의 기본 스택은 Blade 스택입니다. 별도 인자 없이 breeze:install을 실행하고 Blade를 선택하면 됩니다. 스캐폴딩이 완료된 후 프론트엔드 에셋을 빌드합니다:

php artisan breeze:installphp artisan migratenpm installnpm run dev

설치 후 브라우저에서 /login 또는 /register에 접속해 동작을 확인할 수 있습니다. Breeze의 모든 라우트는 routes/auth.php 파일에 정의되어 있습니다.

Breeze와 Livewire

Livewire는 PHP만으로 동적이고 반응형인 UI를 구현할 수 있는 강력한 도구입니다. Vue나 React 같은 SPA 프레임워크 없이 Blade 템플릿 기반으로 인터랙티브한 UI를 만들고 싶은 팀에 특히 적합합니다.

breeze:install 실행 시 Livewire 스택을 선택하면 됩니다. 스캐폴딩 완료 후 마이그레이션을 실행합니다:

php artisan breeze:installphp artisan migrate

Livewire 스택은 프론트엔드 빌드 도구가 필요하지 않으므로 npm install / npm run dev 단계가 없습니다.

Breeze와 React / Vue

Inertia를 통해 React 또는 Vue 기반 SPA를 구성할 수 있습니다. Inertia는 서버 사이드 라우팅과 컨트롤러를 그대로 유지하면서 React·Vue의 프론트엔드 생산성을 함께 활용할 수 있게 해줍니다. Vite의 빠른 빌드 속도와 결합하면 개발 경험이 크게 향상됩니다.

breeze:install 실행 시 Vue 또는 React 스택을 선택합니다. 이때 Inertia SSR 지원 여부와 TypeScript 사용 여부도 함께 선택할 수 있습니다.

php artisan breeze:installphp artisan migratenpm installnpm run dev

설치 후 /login 또는 /register에 접속해 동작을 확인하세요. 라우트는 routes/auth.php에 정의되어 있습니다.

Breeze와 Next.js / API

Next.js, Nuxt 등 별도의 JavaScript 프레임워크를 프론트엔드로 사용하는 경우, Breeze의 API 스택으로 인증 API만 구성할 수 있습니다.

php artisan breeze:installphp artisan migrate

설치 과정에서 .env 파일에 FRONTEND_URL 환경 변수가 추가됩니다. 이 값은 JavaScript 프론트엔드 애플리케이션의 URL로, 로컬 개발 환경에서는 보통 http://localhost:3000을 사용합니다. 또한 APP_URL이 http://localhost:8000으로 설정되어 있는지 확인하세요. 이 값은 php artisan serve 명령의 기본 URL입니다.

Next.js 레퍼런스 구현

Laravel 팀이 관리하는 Next.js용 Breeze 프론트엔드 레퍼런스 구현이 GitHub에 공개되어 있습니다. 이 구현은 Blade 및 Inertia 스택과 동일한 UI를 제공하므로, Next.js와 Laravel을 연동하는 시작점으로 활용할 수 있습니다.

Laravel Jetstream

Breeze가 가볍고 간결한 시작점을 제공한다면, Laravel Jetstream은 더 풍부한 기능을 갖춘 본격적인 스타터 키트입니다. 로그인, 회원가입, 이메일 인증, 2단계 인증(2FA), 세션 관리, Laravel Sanctum 기반 API 인증, 팀 관리 기능을 포함합니다. Jetstream 역시 Tailwind CSS로 디자인되어 있으며, Livewire 또는 Inertia 스택을 선택할 수 있습니다.

설치 방법을 포함한 자세한 내용은 Jetstream 공식 문서를 참고하세요.