Poo26

Poo26 is the 2026 version of Poo.ink the URL shortener. Poo26 is built with...

• Laravel 12
• TailwindCSS v4
• Livewire 3
• Filament Admin Panel
• PestPHP 4 for testing
• FluxUi components

Contents

• Requirements
• Paid Dependencies
• Environment Variables
• Get started with Docker (locally)
  • Build and run with Docker Compose
  • Database
• Getting started locally (without Docker)
• Admin Panel
  • Creating an Admin User
  • Admins in Production
• GitHub Actions
  • CI Workflow (ci.yaml)
  • CD Workflow (cd.yaml)
• Testing
  • Running all tests
  • Running tests and updating snapshots
• Useful notes and commands
  • Building the Docker image manually
  • Trusted proxies

Requirements

• PHP 8.3+
• Composer
• NodeJS 20+
• Docker (optional, for building images)

Paid Dependencies

Poo26 uses FluxUi pro components for the user interface. This is a paid package and a license is required to install the components from their private repository.

If you have a license you can create an auth.json file with your credentials. See Flux documentation for more details.

use the following command to generate an empty auth.json file:

php artisan flux:activate

Environment Variables

Laravel uses environment variables to configure various aspects of the application. Most of the defaults are set in the .env.example file. You can copy this file to .env and modify it as needed.

To disable stack traces in browser set APP_DEBUG=false in your .env file.

Get started with Docker (locally)

Licence: Ensure you have an auth.json file with a valid license to install paid dependencies see Paid Dependencies

Build and run with Docker Compose

The following command will build and start the application using Docker Compose:

DOCKER_BUILDKIT=1 docker compose up --build

Visit http://127.0.0.1:8000 in your web browser to access the application.

Database

This will use a sqlite in memory database, so any data will be lost when the container is stopped. To avoid this modify the docker-compose.yml file to use a persistent database.

Getting started locally (without Docker)

1. Install PHP dependencies using Composer

   Licence: Some dependencies require a valid license and auth.json file to install correctly see Paid Dependencies

   composer install

2. Install JavaScript dependencies using npm, or Bun

   npm install
   # or
   bun install

3. Copy the example environment file and configure your environment variables

   cp .env.example .env

4. Generate an application key (APP_KEY) (if not already done)

   php artisan key:generate

5. Run database migrations

   php artisan migrate

6. Start Vite development server

   npm run dev
   # or
   bun run dev

7. Start the Laravel development server

   php artisan serve

Admin Panel

The admin panel is built using FilamentPHP. To access the admin panel, navigate to Visit http://127.0.0.1:8000/admin in your web browser.

Creating an Admin User

You can create an admin user using the following Artisan command:

php artisan make:filament-user

This will prompt you to enter a name, email, and password for the new admin user.

Admins in Production

In production, you can set the ADMIN_EMAIL environment variable in your .env file to specify the email address of the admin user. This will restrict access to the admin panel to only that email address.

GitHub Actions

The project includes two Github Actions workflows for CI/CD.

ci.yaml

This workflow runs on every pull request to the main branch. It will...

1. Check you have updated the project version in composer.json
2. Run all the Pest tests (excluding screenshot diff tests)

Secrets

This workflow expects the following secrets to be set in the Testing environment of your repository settings:

1. FLUX_USERNAME - The email address associated with your FluxUi account
2. FLUX_LICENSE_KEY - Your FluxUi license key

cd.yaml

This workflow runs on every push to the main branch. It will...

1. Build and push a Docker image to GitHub Container Registry
2. Deploy the app to a CapRover server

Secrets

This workflow expects the following secrets to be set in the Production environment of your repository settings:

1. COMPOSER_AUTH - The contents of your auth.json file for installing paid dependencies, note this secret MUST be a single line JSON string otherwise the workflow will fail.
2. CAP_SERVER_URL - The base URL of your CapRover server e.g https://captain.yourdomain.com
3. CAP_APP_NAME - The name of the app on your CapRover server e.g poo26
4. CAP_APP_TOKEN - The token for your CapRover app

Testing

Poo26 uses PestPHP for testing. Tests are split into Feature and Unit tests located in the tests/Feature and tests/Unit directories respectively.

Poo26 also makes use of Pest's snapshot testing capabilities for UI components. Snapshots are stored in the tests/.pest directory.

Running all tests

php artisan test --parallel

Running tests and updating snapshots

php artisan test --update-snapshots

Useful notes and commands

Building the Docker image manually

Build the docker image with secret auth.json manually ...

DOCKER_BUILDKIT=1
docker build \
  --secret id=composer_auth,src=auth.json \
  -t poo26 .

Trusted proxies

Poo26 is currently configured to trust all proxies by default. If you need to restrict this, you can modify the bootstrap/app.php trustProxies method.