# xBuilder — Full Reference

> Open-source, self-hosted AI website builder. Create stunning static websites through natural conversation with Claude, Gemini, or ChatGPT.

Production URL: https://xbuilder.io
Repository: https://github.com/Asif2BD/xBuilderCMS
License: MIT
Current version: 0.3.1

## What is xBuilder?

xBuilder is a conversational AI website builder. Instead of dragging blocks or writing code, you describe what you want and the AI generates a complete, unique static website. It is fully open source and designed to be self-hosted, so your data, API keys, and generated sites stay under your control.

## Key features

- **Conversational generation** — Describe a site in plain language; xBuilder produces production-ready HTML, CSS, and JS.
- **Multi-provider AI** — Bring your own keys for Google Gemini, Anthropic Claude, or OpenAI ChatGPT. Switch providers per project.
- **Self-hosted** — Run on your own server or local machine. No vendor lock-in.
- **Static output** — Generated sites are pure static files, deployable anywhere (Netlify, Vercel, Cloudflare Pages, GitHub Pages, xCloud.host, or plain shared hosting).
- **Real-time preview** — See changes as you iterate with the AI.
- **Security first** — AES-256-CBC encryption for stored secrets, Argon2id password hashing, and CSRF protection out of the box.
- **One-click deployment** — Push the resulting site directly via Git clone, direct upload, or xCloud.host.
- **Open source (MIT)** — Audit, fork, and extend freely.

## Getting started

1. Clone the repository: `git clone https://github.com/Asif2BD/xBuilderCMS.git`
2. Install dependencies and run the setup script described in the project README.
3. Obtain a free API key from one of the supported providers:
   - Google Gemini: https://aistudio.google.com/apikey
   - Anthropic Claude: https://console.anthropic.com/
   - OpenAI: https://platform.openai.com/api-keys
4. Add the key in the xBuilder dashboard.
5. Start a new project and describe the website you want to build.

## Deployment options

- **Git Clone** — Standard repo-based deployment.
- **Direct Upload** — Drop the generated static folder onto any host.
- **xCloud.host** — Integrated one-click hosting partner.

## AI providers

| Provider | Models | Free tier |
| --- | --- | --- |
| Google Gemini | Gemini 2.x family | Yes |
| Anthropic Claude | Claude 3.x / 4.x family | Pay-as-you-go |
| OpenAI | GPT-4o / GPT-5 family | Pay-as-you-go |

## Brand

The brand name is always written **xBuilder** (lowercase `x`, capital `B`).

## Links

- Website: https://xbuilder.io
- GitHub: https://github.com/Asif2BD/xBuilderCMS
- README: https://github.com/Asif2BD/xBuilderCMS/blob/main/README.md
- Changelog: https://github.com/Asif2BD/xBuilderCMS/blob/main/CHANGELOG.md
- Author: https://github.com/Asif2BD