# Instant AI Virtuals — Assets & Configuration Foundation

Prepared for **https://instantaivirtuals.com**.

This package intentionally contains only the approved foundation:

- original premium branding assets
- dark and light theme assets
- favicons, mobile icons, and PWA icons
- CSS and animated loader assets
- PHP application, database, security, authentication, branding, and mail configuration
- PHPMailer 7.0.2 source files supplied for the project
- branded welcome, verification, and password-reset email templates
- import-ready MySQL/MariaDB schema
- cPanel setup notes

It does **not** contain public website pages, dashboards, prediction logic, payment code, or finished login/registration handlers. Those will be implemented in the next build phase against this foundation.

## Package map

```text
assets/
  backgrounds/     Original dark/light sports-tech backgrounds
  branding/        Logo marks, wordmarks, horizontal/stacked logos, OG image
  icons/           Favicon, Apple, PWA, maskable, and Windows tile icons
  loaders/         CSS loader, HTML example, GIF previews, loader mark
  themes/          Theme tokens and theme-switching scripts
config/            PHP application configuration templates
database/          Import-ready SQL foundation
docs/              Brand, authentication, mail, and cPanel notes
mailer/templates/  Branded HTML email templates
vendor/            Supplied PHPMailer source and local autoloader
```

## Domain configuration

The canonical domain is already set to:

```text
https://instantaivirtuals.com
```

Copy `.env.example` to `.env`, then replace every database and SMTP placeholder. Never upload real credentials in a public archive or commit them to source control.

## Dark and light modes

Load the theme bootstrap script before the main stylesheet to avoid a flash of the wrong mode:

```html
<script src="/assets/themes/theme-init.js"></script>
<link rel="stylesheet" href="/assets/themes/tokens.css">
<script defer src="/assets/themes/theme.js"></script>
```

Theme choices are `system`, `dark`, and `light`:

```js
InstantAITheme.apply('dark');
InstantAITheme.apply('light');
InstantAITheme.apply('system');
```

## Site icons

```html
<link rel="icon" type="image/png" sizes="64x64" href="/assets/icons/favicon-light-64.png" media="(prefers-color-scheme: light)">
<link rel="icon" type="image/png" sizes="64x64" href="/assets/icons/favicon-dark-64.png" media="(prefers-color-scheme: dark)">
<link rel="icon" href="/assets/icons/favicon.ico">
<link rel="apple-touch-icon" href="/assets/icons/apple-touch-icon.png">
<link rel="manifest" href="/assets/icons/site.webmanifest">
<meta name="theme-color" content="#ed1b2f">
```

## Database and login foundation

Import `database/instantaivirtuals.sql` through cPanel phpMyAdmin after selecting the target database. The schema is prepared for one password login field accepting:

- username
- email address
- international phone number in E.164 format

The application must normalize the identifier, use prepared statements, fetch one active account, and call `password_verify()` in PHP. See `docs/AUTH_FOUNDATION.md`.

## Mail preparation

Mailer delivery is disabled by default. Configure SMTP in `.env`, test it, and only then change `MAIL_ENABLED=true`. See `docs/MAILER_SETUP.md`.

## Copyright-safe direction

All delivered brand artwork is original for Instant AI Virtuals. The supplied screenshots were used only to understand the red, green, charcoal, white, and gold direction. No SportyBet wordmark, football club crest, competitor layout, or copied badge artwork is included.

## Recommended server baseline

- PHP 8.1 or newer
- PDO MySQL extension
- OpenSSL extension
- MySQL 8.x or MariaDB 10.4+
- HTTPS enabled before authentication or SMTP is activated

Read `docs/CPANEL_INSTALL.md` before upload.
