Laravel 스타터 킷 만드는 법

​

시작하며

• 공식 문서: Starter Kits
• 공식 구현 예: laravel/react-starter-kit
• 참고 페이지: Laravel Console Starter

​

스타터 킷 작성

​

Laravel 프로젝트를 초기화한다

{
    "name": "example/starter-kit",
    "type": "project",
    "require": {
        "php": "^8.3",
        "laravel/framework": "^13.0"
    }
}

​

composer.json의 scripts를 설정한다

"scripts": {
    "post-root-package-install": [
        "@php -r \"file_exists('.env') || copy('.env.example', '.env');\""
    ],
    "post-create-project-cmd": [
        "@php artisan key:generate --ansi",
        "@php -r \"file_exists('database/database.sqlite') || touch('database/database.sqlite');\"",
        "@php artisan migrate --graceful --ansi"
    ]
}

​

.gitattributes로 배포 대상을 제어한다

LICENSE export-ignore
composer.lock export-ignore
README.md export-ignore

​

Packagist에의 등록

laravel new my-app --using=example/starter-kit

​

laravel new 커맨드의 흐름

• —using 옵션 정의
• create-project와 post-root-package-install의 실행
• getStarterKit()의 구현

​

프론트엔드 프레임워크의 선택

​

버전 업그레이드 유지보수

​

Laravel·PHP 버전 업그레이드 대응

"require": {
    "php": "^8.3",
    "laravel/framework": "^13.0"
}

​

정기적인 의존 패키지 갱신

• Tailwind
• 컴포넌트 라이브러리 (shadcn/ui, shadcn-vue, shadcn-svelte, Flux UI)
• Inertia / Livewire 관련 패키지

​

호환성 테스트

• composer install이 성공한다
• php artisan test가 통과한다
• npm install && npm run build가 통과한다

​

베스트 프랙티스

• name은 이른 단계에서 고정한다: Packagist 공개 후의 변경 비용이 높습니다.
• scripts는 공식 예를 기준으로 한다: 초기화 흐름을 무너뜨리면 도입 실패가 늘어납니다.
• .gitattributes를 처음에 정비한다: 템플릿 배포 시의 노이즈를 줄일 수 있습니다.
• 업그레이드를 정기화한다: Laravel 릴리스 직후 바로 추종할 수 있는 운용을 만들어 주세요.
• 관련 가이드를 함께 읽는다: 패키지 개발의 기초와 패키지의 버전 호환성 관리를 함께 읽으면 설계가 안정됩니다.