스타터 키트

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

소개

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

스타터 키트는 선택 사항입니다. 새 Laravel 프로젝트를 처음부터 직접 구성해도 전혀 문제없습니다. 어떤 방식을 택하든 좋은 결과물을 만들 수 있습니다.

Laravel Breeze

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

기본 뷰 레이어는 Tailwind CSS로 스타일링된 Blade 템플릿으로 구성됩니다. 또한 Livewire 또는 Inertia(Vue / React) 기반의 프론트엔드 스캐폴딩 옵션도 선택할 수 있습니다.

Laravel Bootcamp

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

설치

먼저 새 Laravel 애플리케이션을 생성하고, 데이터베이스를 설정한 뒤 마이그레이션을 실행합니다. 준비가 완료되면 Composer로 Breeze를 설치합니다.

composer require laravel/breeze --dev

패키지 설치 후 breeze:install Artisan 명령어를 실행합니다. 이 명령어는 인증 관련 뷰, 라우트, 컨트롤러 등 모든 리소스를 애플리케이션에 직접 게시합니다. 코드가 프로젝트 안에 포함되므로 동작 방식을 자유롭게 파악하고 수정할 수 있습니다.

명령어를 실행하면 원하는 프론트엔드 스택과 테스트 프레임워크를 대화형으로 선택할 수 있습니다.

php artisan breeze:installphp artisan migratenpm installnpm run dev

Breeze와 Blade

Blade 스택은 Breeze의 기본 옵션으로, 순수 Blade 템플릿으로 프론트엔드를 구성합니다. breeze:install 실행 시 Blade 스택을 선택하면 됩니다. 설치 후에는 프론트엔드 에셋을 빌드합니다.

php artisan breeze:installphp artisan migratenpm installnpm run dev

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

Breeze와 Livewire

Breeze는 Livewire 기반 스캐폴딩도 지원합니다. Livewire를 사용하면 별도의 JavaScript 프레임워크 없이 PHP만으로 동적이고 반응형인 UI를 구현할 수 있습니다.

Vue나 React 같은 SPA 프레임워크 대신 Blade 템플릿 중심으로 개발하면서도 동적인 인터페이스가 필요하다면 Livewire 스택이 좋은 선택입니다.

breeze:install 실행 시 Livewire 스택을 선택하면 됩니다. 설치 후에는 마이그레이션만 실행하면 됩니다(별도의 npm 빌드 불필요).

php artisan breeze:installphp artisan migrate

Breeze와 React / Vue

Breeze는 Inertia를 통해 React 및 Vue 기반 스캐폴딩도 제공합니다. Inertia를 사용하면 서버 사이드 라우팅과 컨트롤러 구조를 그대로 유지하면서 React 또는 Vue로 현대적인 SPA를 구성할 수 있습니다.

즉, Laravel의 강력한 백엔드 생산성과 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

Breeze는 Next.js, Nuxt 등 별도의 JavaScript 프론트엔드 애플리케이션과 연동할 수 있는 인증 API 스캐폴딩도 제공합니다. breeze:install 실행 시 API 스택을 선택하면 됩니다.

php artisan breeze:installphp artisan migrate

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

Next.js 참고 구현체

백엔드 준비가 완료되면 원하는 프론트엔드와 연결할 수 있습니다. Laravel 팀이 공식으로 관리하는 Next.js 기반 Breeze 프론트엔드 구현체가 GitHub에 공개되어 있습니다. 이 구현체는 Blade 및 Inertia 스택과 동일한 UI를 제공하므로 좋은 출발점이 됩니다.

Laravel Jetstream

Breeze가 최소한의 인증 기능을 제공하는 가벼운 출발점이라면, Laravel Jetstream은 더 강력하고 풍부한 기능을 갖춘 스타터 키트입니다.

Jetstream은 로그인, 회원가입, 이메일 인증, 2단계 인증(2FA), 세션 관리, Laravel Sanctum 기반 API 인증, 그리고 선택적 팀 관리 기능을 포함합니다. UI는 Tailwind CSS로 설계되었으며, 프론트엔드 스택으로 Livewire 또는 Inertia를 선택할 수 있습니다.

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