create-larastack-app

Scaffold a Larastack-based monorepo from Liinkiing/larastack with selectable applications:

• frontend (Next.js)
• backend (Laravel)
• mobile (Expo)

The CLI asks for:

• project folder
• application name
• included app folders (checkbox multiselect)
• GitHub username (auto-detected when possible)
• author (John Doe <[email protected]>, auto-filled from git config when possible)
• Expo EAS project ID (optional, when mobile is selected)

It then customizes placeholders like Larastack, larastack, and liinkiing, updates mobile identifiers, removes unselected app folders, and can initialize a fresh git repository.

Requirements

• Node.js >=22
• Corepack enabled
• pnpm >=10

corepack enable
corepack use [email protected]

Usage

npx create-larastack-app@latest

pnpm create larastack-app

bun create larastack-app

You can also pass flags for non-interactive runs:

npx create-larastack-app@latest my-app \
  --name "My App" \
  --apps frontend,backend \
  --author "John Doe <[email protected]>" \
  --github-user mygithub

CLI options

• --name <name>: Application display name
• --apps <apps>: Comma-separated list of frontend,backend,mobile
• --github-user <username>: GitHub username for owner/repository placeholders
• --author <author>: Author for package.json (John Doe <[email protected]>)
• --eas-project-id <id>: Expo EAS project ID (optional)
• --template-source <source>: Override template source (github:Liinkiing/larastack by default)
• --template-ref <ref>: Git reference for the template (master by default)
• --no-git: Skip git init

Local development

pnpm install
pnpm run lint
pnpm run typecheck
pnpm run format:check
pnpm run test
pnpm run build

Run locally:

node dist/cli.js

Release

Releases are manual and run from GitHub Actions with release-it + Conventional Commits.

1. Open Actions and run the release workflow.
2. Choose inputs:
   • bump: auto (recommended), or force patch, minor, major
   • prerelease: none, alpha, beta, rc
   • dry-run: true to preview, false to publish
3. Run it on master.

The workflow lints, typechecks, format-checks, tests, builds, updates CHANGELOG.md, creates the release commit/tag, publishes to npm, and creates a GitHub release.

Local equivalents:

pnpm run release:dry
pnpm run release

Conventional Commit bump rules:

• fix: -> patch
• feat: -> minor
• BREAKING CHANGE: (or !) -> major

If commits are only non-releasable types (chore:, docs:, test:...), use the workflow bump input to force a release.

For npm auth, prefer npm Trusted Publishing (OIDC) for .github/workflows/release.yml. As a fallback, set NPM_TOKEN in repository secrets.

Because the package name is create-larastack-app, users can run the short create commands:

• pnpm create larastack-app
• bun create larastack-app