FAQ

Installation

Which PHP version do I need?
Laravel 10 in this project requires PHP 8.1+. The installer UI also accepts 8.0.2+. Use 8.1 or 8.2 in production. Enable gd, exif, intl, pdo_mysql, mbstring, curl, openssl, xml, tokenizer, ctype, json.

cPanel or Nginx?
Both. cPanel: upload to public_html and run /install. VPS: document root = public/. Details: cPanel, Nginx.

The installer never appears.
The app may already be marked installed, or /install is blocked. Check .env / install state and storage/logs/laravel.log. Confirm Mix JS exists (public/js/app.js).

Purchase code fails.
See License. Confirm APP_URL and outbound HTTPS.

Database connection failed.
On cPanel the host is often localhost and the database name is prefixed (user_dbname). User must have all privileges on that database.

Using tools

Where are the tools?
/tools or the sidebar on any /tools/{slug} page. See Tools workspace.

Do I need an account to design a card?
You can fill Print Studio / digital cards / QR / signatures and download without saving to the database. Saving landing pages, resumes, lead forms, and link-in-bio pages is bound to a logged-in user.

How do I print business cards?
Print Studio → 4 steps → Print (window.print) or Download PNG. Use landscape vs portrait templates. CSV import: /files/card.csv as a column template (name,profession,email,phone,website,company,location).

How do I share a digital profile?
Create link-in-bio, copy /link/{slug}. Point NFC chips and QR codes at that URL so you can change links later.

Why is my landing page 404?
It must be Published. Slug must match /l/{slug}. Signed-in owner edits at /tools/landing-page.

Resume link does nothing.
Toggle Make Public, then Copy Link. URL is /resume/{slug}.

Where do form submissions go?
Builder → View Leads, and Admin → Leads. Export from admin or /lead-forms/{id}/export.

Admin

I cannot save global settings.
APP_DEMO=true blocks updates. Set APP_DEMO=false.

Staff cannot see a menu item.
Their role needs Read on that module. admin slug bypasses checks.

Forgot password does not send mail.
Configure mail and a queue worker.

How do I change the site language?
/language/{code} or the language switcher in the header. Edit strings under Settings → Languages.

Hosting

500 error after upload.
PHP version, missing vendor/, unwritable storage/, bad .env. Read storage/logs/laravel.log.

Images 404.
php artisan storage:link; confirm files under public/images. Rebuild assets only if you changed Vue: npm run prod.

Should I run npm run prod on cPanel?
Only if you customized JS/CSS. Marketplace packages usually include compiled public/js/app.js.

Is _landing/ required?
No. That folder is a separate marketing site. This Laravel app already has public pages.

More failures: Troubleshooting.