# PHPLD Next

PHPLD Next is the modern rebuild of PHP Link Directory. The goal is a free, installable directory app that works without paid AI services, while still offering optional AI-assisted tools for site owners who want them.

The product should support simple link directories, Linktree-style link hubs, niche resource directories, and richer software/product directories.

## Installation

Public release packages are intended to be uploaded to shared hosting and installed from `/install`. The package should include production PHP dependencies and built frontend assets, so the server does not need Composer or Node.

After cloning the project and installing dependencies, run the installer command to prepare a fresh development environment:

```bash
php artisan app:install
```

Optional `--email` and `--password` flags let you control the administrator credentials. When omitted, the command falls back to `admin@example.com` and a generated secure password that is displayed in the console output.

## Building a Release Package

On Windows, build a distributable ZIP and matching update manifest with:

```powershell
powershell -ExecutionPolicy Bypass -File scripts/build-release.ps1
```

The generated files are written to `dist/`. The ZIP is built from the current Git commit, installs production Composer dependencies into a staging folder, builds frontend assets, adds `phpld-release.json`, and writes a manifest containing the package checksum.

## Product Docs

- [Product vision](docs/product-vision.md)
- [Public release roadmap](docs/plans/public-release-roadmap.md)
- [Installer, updater, and tracking plan](docs/plans/installer-updater-tracking.md)

## Development Notes

- Core directory features must work without AI configuration.
- AI features should be opt-in and disabled gracefully when no provider is configured.
- Public release packages should install without Composer or Node on customer hosting.
- Installer, updater, and telemetry must avoid collecting secrets or listing content.

## Framework

PHPLD Next is currently built on Laravel.
