HotCRM

AI-Native CRM for the ObjectStack marketplace. The reference implementation every future marketplace app forks from.

HotCRM is a complete, opinionated CRM built as the first official application on the ObjectStack marketplace. Install it into any ObjectStack environment in one click and get a working CRM in 30 seconds — or fork it as the canonical example of how to build your own marketplace app.

---

📸 Screenshots

Sales pipeline (kanban)	All opportunities (table)

Accounts (cards)	Service cases (kanban)

Executive dashboard

Screenshots show HotCRM running in zh-CN with seeded data. Bundled translations: en, zh-CN, es-ES, ja-JP.

---

✨ What you get

15 business objects spanning the full Lead-to-Cash cycle:

Sales	Service	Marketing	Revenue
crm_lead	crm_case	crm_campaign	crm_contract
crm_account	crm_knowledge_article	crm_campaign_member	crm_quote
crm_contact	crm_task		crm_quote_line_item
crm_opportunity
crm_opportunity_line_item
crm_product
crm_forecast

Plus 2 AI agents (sales-copilot, service-copilot), 4 dashboards, 6 workflows, 10 actions, 4 RAG knowledge bases, 4 language bundles (en, zh-CN, es-ES, ja-JP), 10 role hierarchy, and 3 sharing rules.

---

🚀 Install from the marketplace (recommended)

1. Sign in at cloud.objectos.app.
2. Open Marketplace → HotCRM and click Install into your environment.
3. Open your environment URL — HotCRM is wired into the Studio shell. Done.

First-time on ObjectStack? Create an environment from the Starter template first, then install HotCRM on top.

---

🛠 Run locally (development / fork it)

git clone https://github.com/objectstack-ai/hotcrm.git
cd hotcrm
pnpm install
pnpm dev                    # ObjectStack runtime starts at http://localhost:3000

pnpm typecheck              # strict TypeScript
pnpm build                  # produces dist/objectstack.json (the publishable artifact)

The compiled dist/objectstack.json is the package — that's what gets uploaded to the marketplace.

---

📦 Publish a fork to the marketplace

After you've forked, customized, and renamed the package:

# 1. Authenticate once (writes ~/.objectstack/cloud.json)
objectstack cloud login

# 2. Build the artifact
pnpm build

# 3. Publish a new version
objectstack package publish dist/objectstack.json \
  --manifest-id app.acme.crm \
  --version 1.0.0 \
  --display-name "Acme CRM" \
  --category crm \
  --visibility marketplace \
  --note "Initial release"

The CLI is idempotent: re-running with the same --manifest-id updates the package; new --version values create immutable versioned snapshots.

See docs: Publishing your first marketplace app for the full walkthrough.

---

🏗 Repository layout

hotcrm/
├── objectstack.config.ts         # manifest + defineStack() — single source of truth
├── src/
│   ├── objects/                  # *.object.ts — data model (15 objects)
│   ├── actions/                  # *.action.ts — server actions + AI tools (10)
│   ├── flows/                    # *.flow.ts — visual workflows (6)
│   ├── hooks/                    # *.hook.ts — server-side triggers
│   ├── agents/                   # *.agent.ts — AI copilots (2)
│   ├── skills/                   # *.skill.ts — AI skills (5)
│   ├── rag/                      # *.rag.ts — RAG knowledge bases (4)
│   ├── cubes/                    # *.cube.ts — analytics cubes
│   ├── dashboards/, reports/     # analytics UI
│   ├── pages/, views/, apps/     # UI definitions
│   ├── profiles/, sharing/       # security
│   ├── approvals/                # approval processes
│   ├── translations/             # en / zh-CN / es-ES / ja-JP
│   └── data/                     # seed data
└── apps/docs/                    # Fumadocs site (https://github.com/objectstack-ai/hotcrm/tree/main/apps/docs)

Every file follows the <entity>.<kind>.ts convention. The crm_ prefix on object names is explicit in source — no runtime magic. Both rules are required for marketplace acceptance.

---

📚 Documentation

• Live docs: start pnpm --filter docs dev, then open http://localhost:3001/docs
• For business users: Sales, Service, Marketing, Revenue, AI Copilot guides
• For developers: Architecture, Customization, API reference, Testing & CI
• For publishers: Marketplace publishing guide

---

🤝 Why fork HotCRM?

Because it's the reference for every ObjectStack convention you'll encounter:

• ✅ crm_ namespace prefix on every object (explicit, grep-able, marketplace-safe)
• ✅ Strict *.object.ts / *.hook.ts / *.action.ts separation of concerns
• ✅ All metadata validated against @objectstack/spec schemas
• ✅ ObjectQL only — no raw SQL anywhere
• ✅ AI-Native — every entity has an *.action.ts that's also an AI tool
• ✅ Four-language i18n out of the box
• ✅ Production-shaped sharing rules, profiles, and role hierarchy

If you want to ship an HR app, a project tracker, a help-desk — start by reading HotCRM's structure, then change names.

---

📄 License

Apache-2.0. See LICENSE.