# Quorla website (quorlasocial.com)

Marketing site for Quorla. The app itself lives in the separate repo `claude_Metatron_Social_Media_Manager`
(served at app.quorlasocial.com). Built with [Astro](https://astro.build): pages compile to plain static HTML.

What to build and the rules: **[REQUIREMENTS.md](REQUIREMENTS.md)**. AI agents also read [AGENTS.md](AGENTS.md).

## Work on it

### One-time setup (your PC)
1. Install **Node.js 22.23.4 or newer** (LTS from nodejs.org). Check with `node -v`.
2. Clone and install:
   ```bash
   git clone https://git.metatroncube.in/MetatroncubeSoftwareSolutions/quorla-website.git
   cd quorla-website
   npm install
   ```
   On this PC the folder already exists: `D:\MCS_Repos\2026\Quorla_Website`. Open that folder in Antigravity.

### Every time
```bash
git pull                 # get the latest
npm run dev              # live preview at http://localhost:4321 (reloads as you edit)
npm run build            # check the production build before committing
git add -A && git commit -m "What changed" && git push
```
Then deploy (below). If Node is older on a machine, build with Docker instead (same command as the server).

| What | Where |
|---|---|
| Pages (one file = one URL) | `src/pages/` (`index.astro` → `/`, `privacy.astro` → `/privacy`) |
| Header, footer, `<head>` | `src/layouts/Base.astro` |
| Styles (navy `#242142`, coral `#FC6D45`) | `src/styles/global.css` |
| Logos, icons, images | `public/assets/` |

## Deploy (HestiaCP server, as `dev`)

HestiaCP serves `/home/user/web/quorlasocial.com/public_html/` as plain static files.

```bash
cd ~/APPS/quorla-website && git pull
# Build with Docker so the server doesn't need Node (Astro 7 needs Node >= 22.23.4):
docker run --rm -v "$PWD":/site -w /site node:22-bookworm-slim sh -c "npm ci && npm run build"
sudo rsync -a --delete --chown=user:user --chmod=D755,F644 dist/ /home/user/web/quorlasocial.com/public_html/
```

## Contact form

`/contact` sends through `public/api/contact.php` using the server's own mail to support@quorlasocial.com (details in
REQUIREMENTS.md §6). After deploying, submit the form once on the live site and check the support@ inbox.

## Keep these working

Google's OAuth verification and TikTok's app review point at these URLs. Don't remove or move them:
- https://quorlasocial.com (home page, must explain the app and link to the privacy policy)
- https://quorlasocial.com/privacy and /terms (also still served by the app at app.quorlasocial.com/privacy and /terms;
  keep both copies the same until the app's links and the review forms point here)
- The Google and TikTok domain verification records are DNS TXT records, not files, so redeploying the site doesn't affect them.

## Page plan

Home · Features · Platforms · Pricing (hosted and self-hosted) · For agencies · Blog · Help/Docs · Contact / Book a demo
· Privacy · Terms