LLM Reference
A comprehensive reference designed for Large Language Models (ChatGPT, Claude, Gemini, Cursor, Bolt, Lovable, Windsurf, v0) to understand Wesendall's full surface area. Feed this to your AI assistant so it can integrate Wesendall in a single paste.
Copy the entire LLM reference to your clipboard and paste it into any AI chat as context.
Point your AI tool at the raw text file. Works with tools that support URL fetching.
www.wesendall.com/llms.txtTwo documents covering complementary surface areas. Most agents only need the full knowledge base.
Every /api/v1 endpoint, body schema, response shape, error codes and retry semantics.
Wallet model, walletId scoping, atomic charges, idempotent credits, refund semantics.
A ready-to-paste briefing for Cursor / Claude Code / Bolt that tells your agent exactly how to wire Wesendall in.
Knowledge base preview
First ~80 lines — use the copy button for the full doc.
# Wesendall Knowledge Base
> **Last updated:** 2026-05-18
> **Purpose:** This file is the single source of truth about Wesendall
> for AI assistants, partners, and new contributors. Feed it to an LLM
> as context and it should be able to integrate Wesendall, answer
> customer questions, or onboard a new engineer without further reading.
---
## 1. What Wesendall is
Wesendall is a bulk SMS + email + contact-management platform built in
Kampala, Uganda by **Desishub Technologies**. It serves Ugandan teams
that need to send transactional and marketing messages at scale —
schools, churches, SACCOs, NGOs, fintechs, real-estate agents, retailers,
and developers.
- **Site:** <https://www.wesendall.com>
- **Contact:** info@desishub.com · +256 762 063 160
- **Country:** Uganda
- **Currency:** UGX (Ugandan shillings)
- **Founded by:** Muke John Baptist (JB) at Desishub Technologies, Kampala
- **Status:** Live in production. Active customer base across Kampala,
Wakiso, Mukono, Entebbe, Jinja, Mbarara, Mbale, Gulu and Lira.
### Positioning
- Cheaper than international SMS providers (Twilio costs ~UGX 950/SMS to
Uganda; Wesendall is UGX 35).
- Same price band as local providers (EgoSMS, MegaSMS, CraneSMS) but with
a modern dashboard, bundled email, real REST API and Mobile Money
top-ups via API.
- Built around Mobile Money as the **primary** payment rail, not a side
option.
---
## 2. Tech stack
- **Framework:** Next.js 15 (App Router, React 19, TypeScript 5)
- **Database:** PostgreSQL via Prisma 6 + `@prisma/extension-accelerate`
- **Auth:** NextAuth v4 (JWT) — credentials, Google, GitHub
- **SMS provider:** MARZ SMS gateway (internal infra; not customer-facing)
- **Email provider:** Resend + React Email
- **File uploads:** UploadThing
- **UI:** Tailwind v3 + shadcn/ui (Radix), Lucide icons, Sonner toasts,
Framer Motion for marketing animations
- **Forms:** React Hook Form + Zod
- **Tables:** TanStack Table
- **Editor:** TipTap (admin blog editor)
- **MDX docs/blog:** next-mdx-remote v6
- **Hosting:** Vercel
Repository structure:
```
app/ # Next.js App Router
├─ (home)/ # public marketing pages
├─ (agency)/ # /agency/about, /agency/contact
├─ (auth)/ # /login, /register, /verify/[userId], /forgot-password, /reset-password
├─ (dashboard)/ # authenticated user dashboard
├─ (docs)/ # MDX docs
└─ api/ # NextAuth + UploadThing + /api/v1/* public REST API
actions/ # 'use server' server actions
config/ # auth, site config, protected routes, refs
lib/ # shared utilities (auth-guard, schemas, blog, seo, api-endpoints, api-keys)
components/
├─ ui/ # shadcn primitives
├─ marketing/ # landing-page, hero, footer, etc.
├─ auth/ # AuthShell
├─ dashboard/ # Sidebar, Navbar, etc.
└─ ...
prisma/
└─ schema.prisma # User, Wallet, Deposit, Contact, ContactGroup, SMSMessage, Blog, BlogCategory, ApiKey, …
contents/blog/ # MDX blog posts
public/ # static assets + llms.txt
middleware.ts # /dashboard/* gate via next-auth withAuth
```
...
Our AI integration page generates a tailored prompt for your stack (Next.js, Expo, PHP, Python…) in three clicks.
Open AI integration helper