Get started

Set it up with AI

You don't have to read every page. An AI assistant like Claude can read these docs for you and walk you through each step, write your texts, or build an app with you. This page has ready-made prompts.

#Step 0: give your assistant the docs

Every page here is also plain Markdown, written so assistants can read it:

Address	What it is
`https://docs.facia.chat/llms.txt`	A short index of every page, with links
`https://docs.facia.chat/llms-full.txt`	All of the docs in one file
Any page + `.md`	That page as Markdown, e.g. `https://docs.facia.chat/setup/email.md`
Copy page for AI (bottom of each page)	Copies the page so you can paste it into a chat

If your assistant can open web pages (Claude, ChatGPT with browsing, Claude Code, Cursor…), just give it the llms-full.txt address. If it can't, open that address yourself, copy everything, and paste it in.

#Plan your whole server

text

Read https://docs.facia.chat/llms-full.txt. I run [describe your business: what you sell,
who your clients are, how many staff, where clients find you today].

Plan my Facia server with me:
1. Which feature bundle (Support, Community or Club) and which extra switches, and why.
2. My welcome message, a one-line description, and my support links.
3. Which groups and channels to create, who can join each, and the first post for each.
4. What Verified and VIP members should get (perks), and whether to use levels and coins.
5. Two or three blocks (pages, polls, announcements, missions, spins) for my first month.
6. The team roles and agent permissions I should use for [N] people.
Ask me questions first if something is unclear. Then give me a checklist I can tick off
in HQ, with the exact menu path for each step.

#Write your texts

text

Using the Facia docs (https://docs.facia.chat/llms-full.txt), write for my business [name, what we do]:
- a welcome message (max 3 short sentences) and up to 4 ideas for welcome photos,
- a one-line business description,
- Verified member perks and VIP perks (3–5 each, short),
- 10 saved replies for the questions we get most: [list them],
- level rewards for levels 2, 5 and 10.
Match this tone: [friendly / formal / playful]. Keep everything short; it's read on phones.

#Set up your own domain

text

Read https://docs.facia.chat/setup/domains.md. My domain is [yourbrand.com], registered at
[GoDaddy / Namecheap / Cloudflare / …]. I want my Facia chat at [chat.yourbrand.com].
Walk me through it one step at a time with screenshots-level detail for my registrar:
which DNS record to add, exactly what to type in each field, and how to check it worked.
Wait for me to say "done" after each step.

#Send email from your own domain (Resend)

text

Read https://docs.facia.chat/setup/email.md. I want Facia's sign-in and verification emails
to come from [no-reply@mail.yourbrand.com]. My DNS is at [Cloudflare / other].
Tell me which of the three options fits me best (Facia's address, my own domain through
Facia, or my own Resend account), then walk me through it step by step. If I use
Cloudflare, tell me exactly how to create the one-time API token Facia asks for.

#Connect an AI provider key

text

Read https://docs.facia.chat/setup/ai-keys.md. Help me connect [Anthropic / OpenAI / my own
OpenAI-compatible server] to my Facia business bot. Tell me where to create the key,
which model to pick for a small business on a budget of about [$X] a month, and what
monthly cap to set in Facia. Don't ask me to paste the key here.

#Design your games and activities

text

Read https://docs.facia.chat/business/blocks.md and https://docs.facia.chat/business/games.md.
My community is [describe]. Design a 4-week plan of blocks: for each one, give the kind
(page, poll, announcement, mission or raffle spin), every field exactly as Facia names it
(title, where it shows, who sees it, layout, tone, text, prizes, times), and why it helps.
Keep coin prizes within [budget] coins a week.

#Build an app with Claude Code (or any coding assistant)

Open your coding assistant in an empty folder and paste:

text

Read https://docs.facia.chat/llms-full.txt, especially the "Build on Facia" pages.
Build me a Facia app: [describe it — e.g. "a daily trivia game where Verified members
answer 5 questions and the top scores go on the leaderboard board 'trivia'"].

Requirements:
- A small Node (Express) server plus one static page. Keep it simple.
- Read facia_token from the page address, send it to the server, verify it there with
  FACIA_APP_SECRET and FACIA_APP_ID (HS256, issuer "facia", audience = app id).
- Apply Facia's theme with facia-app.js and call Facia.ready() when drawn.
- Use only the partner API calls the app needs, with a ref on every coin call.
- Store data keyed by the token's biz + sub. Never ask for names, emails or payment details.
- Read secrets from a .env file (FACIA_APP_ID, FACIA_APP_SECRET, FACIA_API). Add .env to .gitignore.
- Tell me which permissions to tick in HQ → Settings → Apps, and how to deploy it.

When it's done, register it as in Your first app and paste the secret into the server's .env yourself.

#Let an assistant use Facia directly

Coming soon A Facia MCP server will let assistants register apps, rotate secrets and read your setup with your permission. Until then, the assistant plans and builds, and you click through HQ. Each step above tells you exactly where.

#Tips for good answers

Say what your business is and who your clients are. The setup depends on it.
Ask for exact menu paths ("HQ → Settings → …"). The docs have them for every screen.
Ask the assistant to wait for "done" between steps when you're changing DNS or settings.
If something on screen doesn't match, tell the assistant what you see, and check What's in beta.

View as Markdown