Akubrecah - KRA Compliance & PDF Intelligence Platform

One Suite. Infinite Power.

Akubrecah is a professional-grade, unified platform designed for Kenyan taxpayers and global document professionals. It seamlessly integrates essential KRA (Kenya Revenue Authority) Compliance services with a comprehensive suite of 88+ Browser-Based PDF Tools.

---

---

🚀 Core Features

🇰🇪 KRA Gateway (Compliance Simplified)

Empowering Kenyan taxpayers with instant, reliable compliance tools:

• PIN Verification: Instantly verify KRA PINs by ID number or PIN.
• Nil Return Filing: File your Nil returns in seconds with automated validation.
• Compliance Tracking: Keep tabs on your tax obligations with a professional dashboard.
• Secure Integration: Direct, encrypted communication with KRA API endpoints.

📄 PDF Mastery Suite (88+ Professional Tools)

A powerhouse for document management, processed entirely in your browser for maximum privacy.

• Conversion: PDF to Word, Excel, PowerPoint, Image, and Markdown.
• Manipulation: Merge, Split, Rotate, Delete Pages, and Reorder.
• Optimization: Bank-grade compression and linearize for web.
• Security: Password protection, PDF Signing (e-signature), and Watermarking.
• Advanced OCR: AI-powered text extraction from scanned documents using Tesseract.js.
• Local Processing: Powered by LibreOffice WASM and pdf-lib—your sensitive data never leaves your device.

---

🛠 Technical Stack

Category	Technology
Framework	Next.js 16 (App Router)
Language	TypeScript
Styling	Tailwind CSS 4
Authentication	Clerk
Database	Prisma with Neon (PostgreSQL)
Payments	Stripe
Animations	Framer Motion
PDF Core	LibreOffice WASM, pdf-lib, pdfjs-dist, jspdf, html2pdf.js, zgapdfsigner
OCR	Tesseract.js
Internationalization	next-intl

---

🏗 Architecture Highlights

• Privacy-First Design: Heavy-duty document processing is performed on the client-side using WebAssembly (WASM), ensuring user documents are never uploaded to our servers.
• Global Ready: Fully localized routing and content management system via next-intl.
• Serverless Performance: Optimized for Vercel with serverless edge functions and Neon's autoscaling database.
• Modern UI: A premium dark-mode aesthetic with interactive micro-animations and responsive layouts.

---

⚙️ Getting Started

Prerequisites

• Node.js 20.x or higher
• PostgreSQL (or Neon account)
• Clerk account
• Stripe account (for payments)

1. Clone & Install

git clone https://github.com/Akubrecah/AkubrecaH-Dev-Cave.git
cd Akubrecah-Dev-Cave
npm install

2. Environment Variables

Create a .env file in the root directory and populate it with the following:

# Database
DATABASE_URL="your_postgresql_url"

# Authentication (Clerk)
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY="pk_test_..."
CLERK_SECRET_KEY="sk_test_..."

# Payments (Stripe)
STRIPE_SECRET_KEY="sk_test_..."
STRIPE_WEBHOOK_SECRET="whsec_..."
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY="pk_test_..."

# KRA API Credentials
KRA_ID_CONSUMER_KEY="your_key"
KRA_ID_CONSUMER_SECRET="your_secret"
KRA_PIN_CONSUMER_KEY="your_key"
KRA_PIN_CONSUMER_SECRET="your_secret"
KRA_NIL_CONSUMER_KEY="your_key"
KRA_NIL_CONSUMER_SECRET="your_secret"
KRA_NIL_API_BASE_URL="https://api.kra.go.ke" # or sandbox

3. Database Setup

npx prisma generate
npx prisma db push

4. Run Development Server

npm run dev

Open http://localhost:3000 to view the application.

---

🚢 Deployment

The project is optimized for deployment on the Vercel Platform.

1. Push your code to GitHub.
2. Link your repository to a new Vercel project.
3. Configure the environment variables in the Vercel dashboard.
4. Deploy!

---

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

---

📄 License

This project is private and proprietary. © 2026 Akubrecah Team.