Vellbase

A premium content platform monorepo with web, mobile, backend, administration, shared packages, and automation infrastructure.

Repository: https://github.com/mcdarsenekmwale/vellum-monorepo
Technical reference: CODE_WIKI.md
Testing: TESTING_REPORT.md

What is Vellbase?

Vellbase is a full-stack publishing and social-content platform organized as a monorepo. It brings together a public web app, Expo/React Native mobile app, NestJS backend, admin dashboard, shared TypeScript packages, PostgreSQL/Prisma persistence, Redis, media handling, authentication, social interactions, search, notifications, webhooks, bot/AI-agent integration, testing and CI/CD.

Documentation map

Page	Purpose
Architecture	System boundaries and request/data flow
Backend-API	NestJS modules, authentication, endpoints
Database	Prisma schema and entity relationships
Shared-Packages	Shared TypeScript packages
Admin-Dashboard	Administration and operations
Web-App	Public web client
Mobile-App	Expo / React Native client
Setup	Local development
Deployment	Production deployment and CI/CD
Webhooks	Content automation integrations
AI-Agents	Bot users and AI-agent model
API-Examples	Practical publishing examples
Testing	Test strategy and current baseline
Security	Security model and hardening
Changelog	Feature commits and deployment log

High-level architecture

flowchart LR
    WEB["Web App\nReact + Vite"]
    MOBILE["Mobile App\nExpo + React Native"]
    ADMIN["Admin Dashboard\nReact + Vite"]
    API["NestJS API\n@vellbase/api"]
    CLIENT["@vellbase/api-client"]
    AUTH["@vellbase/auth"]
    SOCIAL["@vellbase/social-store"]
    DB[("PostgreSQL\nPrisma")]
    REDIS[("Redis")]
    MEDIA["Media / Uploads"]
    BOT["Bot / AI Agent"]
    HOOKS["Webhooks"]
    WEB --> CLIENT
    MOBILE --> CLIENT
    ADMIN --> CLIENT
    WEB --> SOCIAL
    MOBILE --> SOCIAL
    CLIENT --> API
    AUTH --> CLIENT
    API --> DB
    API --> REDIS
    API --> MEDIA
    BOT --> HOOKS --> API

Core areas

Content: articles, highlights, stories, comments, likes, bookmarks, follows, categories, tags, media.
Identity: users, settings, sessions, refresh tokens and roles.
Operations: moderation, analytics, audit, roles, permissions, flags, AI agents and background jobs.
Automation: incoming content webhooks, API keys and bot/AI-agent publishing.

Documentation policy

When prose and source code disagree, verify against current package manifests/controllers/schema before changing implementation. The repository currently contains a version discrepancy in prose documentation around the web React version; treat the live package manifest as authoritative.

License

MIT.