Avanzar In Time Shop is a self-hosted, full-stack e-commerce platform built for developers who need complete ownership of their storefront infrastructure. It ships as a Bun monorepo containing three production-ready apps — a Hono REST API, a React admin dashboard, and an Astro public storefront — wired together through two shared packages that enforce type-safe validation and a single database schema across every layer. Designed with the Cuban market in mind, the platform supports province-based shipping configuration and manual payment verification workflows (cash on delivery, local bank transfer, and Zelle), making it practical for regions where automated payment gateways are unavailable or unreliable.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/ItsJhonAlex/Ecommerce/llms.txt
Use this file to discover all available pages before exploring further.
Apps and Packages
@avanzar/backend
Hono v4 REST API running on port 3000. Handles authentication via Better Auth, all business logic, and exposes interactive OpenAPI docs at
/api/v1/docs.@avanzar/admin
React 19 admin SPA on port 5174. Built with TanStack Query, Radix UI, and Tailwind v4 for managing products, orders, payments, users, and shipping zones.
@avanzar/storefront
Astro v6 public storefront on port 4321. Serves the customer-facing catalog, cart, and checkout experience with island-based interactivity.
@avanzar/db
Drizzle ORM schema and PostgreSQL client shared by the backend. Single source of truth for all table definitions, enums, and migrations.
@avanzar/shared
Zod v4 validation schemas shared across all apps. Covers checkout, orders, products, addresses, payments, shipping, and users — the single source of validation truth.
Once the backend is running, interactive API documentation is available at
http://localhost:3000/api/v1/docs via the Swagger UI powered by @hono/swagger-ui.Tech Stack
| Layer | Technology |
|---|---|
| Runtime & package manager | Bun ≥1.0 |
| API framework | Hono v4 |
| Authentication | Better Auth v1 (email + password, cookie sessions) |
| ORM & migrations | Drizzle ORM + drizzle-kit |
| Database | PostgreSQL 17 (Docker) |
| Admin UI | React 19 + TanStack Query v5 + Radix UI + Tailwind v4 |
| Storefront | Astro v6 |
| Validation | Zod v4 |
| TypeScript config | ESNext target, bundler module resolution |