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.

This repository's own README undersells what's actually here

The root README.md and infrastructure/cloudflare/README.md list 5 applications and describe Cloudflare deployment as "intentionally manual." Neither is accurate today: there are 7 applications (two - embroidery-web and admin-web - aren't mentioned in either file), and .github/workflows/ci.yml deploys to production automatically on every push to main. This portal documents the repository as it actually is - see Architecture → Applications "What the existing docs don't mention" 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 (2 also run their own Worker-side API 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 (static)	✅	✅
Embroidery	`embroidery.akshayagroupglobal.com`	React/Vite (static)	✅	✅
Admin	`admin.akshayagroupglobal.com`	React/Vite, worker-first	✅	✅
Investors	`investors.akshayagroupglobal.com`	React/Vite (static)	⚠️ manual only	❌
API	`api.akshayagroupglobal.com`	Hono-style Worker + D1 + R2	✅	✅ (`/api/health`)

Investors is the one app that's part of neither the automatic pipeline nor the smoke test - documented, not silently fixed, in CI/CD → Deployment.

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¶

Local: npm run dev:<app> - see Deployment → Local.
Production: automatic on push to main (or manual dispatch of deploy-cloudflare.yml) - see Deployment → Production. No staging/preview environment exists - see Deployment overview for why this portal doesn't invent one.

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¶

Architecture · Applications · Local Development · Cloudflare Platform · CI/CD · Infrastructure · Deployment · Operations