Files
ladill-link/DEPLOY.md
T
isaaccladandCursor d9c91ad7d8 Add Ladill Link URL shortener on ladl.link.
Management UI at link.ladill.com with GHS 0.05 per link wallet billing,
click analytics, and legacy fallback to ladill.com/q for QR ecosystem codes.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-06-27 10:58:41 +00:00

48 lines
1.2 KiB
Markdown

# Ladill Link — deployment
Ladill Link is the platform URL shortener. Public short URLs live on **ladl.link**; the management app runs at **link.ladill.com**.
## Domains
| Host | Purpose |
|------|---------|
| `ladl.link` | Public short-link resolution (`/{slug}`) |
| `link.ladill.com` | SSO management UI (create/edit links) |
Both vhosts point at the same Laravel app. Set `LINK_PUBLIC_DOMAIN=ladl.link` in `.env`.
## Pricing
GHS **0.05** per link created (`LINK_PRICE_PER_LINK_GHS`). Debited from the central UserWallet via the Billing API.
## Platform onboarding
From the monolith:
```bash
php artisan ladill:onboard-app link --run-dns
php artisan ladill:launcher:sync --propagate --push
```
Register the Passport OIDC client:
```bash
php artisan passport:client \
--name="Ladill Link" \
--redirect_uri="https://link.ladill.com/sso/callback"
```
Set `BILLING_API_KEY_LINK` and `IDENTITY_API_KEY_LINK` on both monolith and this app.
## Legacy URLs
`https://ladill.com/q/{code}` continues to work for existing QR and storefront codes. New links use `https://ladl.link/{code}`. Unknown slugs on ladl.link fall back to the legacy resolver.
## Database
```bash
php artisan migrate --force
```
Database name: `ladill_link`.