Skip to content

Akshaya Group Global Engineering Portal

What is Akshaya Group Global?

A Cloudflare-first monorepo: seven React + TypeScript + Vite applications and one API Worker, deployed as Cloudflare Workers (Static Assets + a couple with their own dynamic Worker routes), backed by one D1 database and one R2 bucket. There is no staging environment - main is production, and every push to main deploys automatically. See Architecture for the full picture.

Root README corrected as part of fix/platform-hardening

The root README.md previously listed 5 applications (omitting embroidery-web and admin-web) and described Cloudflare deployment as "intentionally manual." Both were corrected directly in README.md: it now lists Embroidery and Admin with their real domains, notes Investors' current excluded/inactive status, and describes the actual automatic-on-push deploy-production pipeline. infrastructure/cloudflare/README.md was left as historical infrastructure-bootstrap documentation, out of scope for that fix. See Architecture → Applications for the full detail.

Architecture overview

Developer
   |
   v
GitHub  --(PR)-->  ci.yml "validate"  (build all 7 apps, typecheck API, unit tests)
   |
  (merge to main)
   |
   v
ci.yml "deploy-production"  (automatic - D1 migrations -> API -> 6 of 7 apps -> smoke test)
   |
   v
Cloudflare
   |
   +--> 7 Worker Static-Assets apps (Corporate, Software and, since
   |     feature/commerce-production-backend, Commerce also run their own
   |     Worker-side API routes; Admin is worker-first for all routes)
   +--> 1 API Worker  ---->  D1 (akshaya-group-global)  +  R2 (akshaya-group-global-files)

Full detail: Architecture → Platform.

Applications

App Domain Framework Deployed automatically? Smoke-tested?
Corporate akshayagroupglobal.com React/Vite + Worker routes ✅ ✅
Software software.akshayagroupglobal.com React/Vite + Worker routes ✅ ✅
Logistics logistics.akshayagroupglobal.com React/Vite (static) ✅ ✅
Commerce commerce.akshayagroupglobal.com React/Vite + Worker routes (D1-backed) ✅ ✅
Embroidery embroidery.akshayagroupglobal.com React/Vite (static) ✅ ✅
Admin admin.akshayagroupglobal.com React/Vite, worker-first ✅ ✅
Investors investors.akshayagroupglobal.com React/Vite (static) 🚫 out of scope / inactive ❌
API api.akshayagroupglobal.com Hono-style Worker + D1 + R2 ✅ ✅ (/api/health)

Investors is currently excluded / inactive for the active platform - by explicit scope decision, not an oversight - and is part of neither the automatic pipeline nor the smoke test. See CI/CD → Deployment for the full detail.

Quick start

git clone https://github.com/Thirunk/akshaya-group-global.git
cd akshaya-group-global
npm install
npm run dev:corporate      # or dev:software / dev:logistics / dev:commerce / dev:embroidery / dev:admin / dev:investors
Full detail: Local Development.

Deployments

Common operations

npm run smoke:production          # read-only HTTP checks against all 7 public endpoints
wrangler tail --config workers/api/wrangler.jsonc   # live API logs (read-only)
Full reference: Operations.

Troubleshooting

Start at Cloudflare → Troubleshooting or Operations → Troubleshooting depending on whether the problem is local development or a live deployment.

Important safety notes

  • No staging environment - main is production. Treat every merge to main accordingly.
  • Production deploys automatically on push to main - there is no manual approval gate in this repository today (see CI/CD → Deployment).
  • No automated rollback exists, by design - see Operations → Rollback.
  • This portal never modifies production DNS, Worker routes, D1 data, or R2 content - every mutating command shown is labeled, and none are executed as part of building this documentation.

More detail