tbleckert/libero

The skeleton application for the Laravel framework.

Maintainers

Package info

github.com/tbleckert/libero

Type:project

pkg:composer/tbleckert/libero

Transparency log

Statistics

Installs: 4

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

dev-main 2026-08-02 18:23 UTC

Requires

Requires (Dev)

MIT f900e6de28fd430d25642adb731f0e0ccbe057bd

frameworklaravel

Published on Packagist.org on 2026-08-02 18:23 UTC

This package is auto-updated.

Last update: 2026-08-02 18:23:52 UTC

README

Libero for Laravel is a small backend starter kit for native apps. It starts with iOS and gives you a Laravel API with email-verified users, Sign in with Apple, Sanctum API tokens, Filament admin, APNs push notifications, versioned endpoints, and Horizon queues.

Getting Started

composer setup

Run the local development stack:

composer dev

This starts the Laravel server, Horizon queue worker, and Pail logs. Horizon requires Redis, and .env.example uses QUEUE_CONNECTION=redis by default.

Create an admin user for Filament:

php artisan make:filament-user

The admin panel is available at /admin. The API starts at /api/v1.

Main Endpoints

  • GET /api/v1/health
  • POST /api/v1/auth/register
  • POST /api/v1/auth/tokens
  • POST /api/v1/auth/apple
  • POST /api/v1/auth/forgot-password
  • POST /api/v1/auth/reset-password
  • GET /api/v1/user
  • PATCH /api/v1/user
  • PUT /api/v1/user/password
  • POST /api/v1/push-devices
  • DELETE /api/v1/push-devices

Authenticated requests use a Sanctum bearer token:

Authorization: Bearer <token>

Apple Setup

In Apple Developer, create or select an explicit App ID for your iOS app. Enable Sign in with Apple and Push Notifications for that App ID.

Set these values in .env:

APPLE_TEAM_ID=
APPLE_IOS_CLIENT_ID=com.example.App
APPLE_KEY_ID=
APPLE_PRIVATE_KEY_BASE64=

APNS_TEAM_ID="${APPLE_TEAM_ID}"
APNS_KEY_ID=
APNS_PRIVATE_KEY_BASE64=
APNS_BUNDLE_ID="${APPLE_IOS_CLIENT_ID}"

LIBERO_ADMIN_EMAILS=admin@example.com
LIBERO_EMAIL_VERIFIED_URL=https://example.com/email-verified
LIBERO_PASSWORD_RESET_URL=https://example.com/reset-password

Sign in with Apple

  1. Create an explicit App ID with your app bundle ID, for example com.example.App.
  2. Enable Sign in with Apple on that App ID.
  3. Create a Sign in with Apple private key.
  4. Copy the key ID into APPLE_KEY_ID.
  5. Base64 encode the downloaded .p8 key into APPLE_PRIVATE_KEY_BASE64:
base64 < AuthKey_XXXXXXXXXX.p8 | tr -d '\n'

For native iOS, APPLE_IOS_CLIENT_ID is your app bundle ID. If you later add web Sign in with Apple, create a Services ID and put it in APPLE_WEB_CLIENT_ID.

Push Notifications

  1. Enable Push Notifications on the same App ID.
  2. Create an APNs auth key.
  3. Copy the APNs key ID into APNS_KEY_ID.
  4. Base64 encode the downloaded .p8 key into APNS_PRIVATE_KEY_BASE64.
  5. Set APNS_BUNDLE_ID to the app bundle ID that receives notifications.

Never commit .env or .p8 files.

Queues

Queues run through Horizon. Keep QUEUE_CONNECTION=redis for local development and production, and use composer dev locally to start Horizon with the rest of the development stack.

Testing

composer test

Apple References