Framework & Core
@medusajs/medusa
v2.x
Core e-commerce backend framework with built-in order, cart, and product management.
Main server framework, REST API endpoints, database ORM
@medusajs/framework
v2.x
Medusa framework primitives and utilities for plugin development.
Plugin system, module registration, configuration
MikroORM
v5.x
TypeScript ORM for database abstraction and migrations.
Entity definitions, database queries, schema management
Loyalty Integration
axios
v1.6+
HTTP client for making REST API calls to PDI Conexxus.
Member validation, points lookups, reward management
opossum
v7.x
Circuit breaker pattern for PDI API resilience.
Fault tolerance, fallback handling, call degradation
jsonwebtoken
v9.x
JWT handling for OAuth2 token management and validation.
Token signing, verification, claims parsing
Payment & Auth
stripe
v13.x
Stripe payment processor integration.
Payment methods, charges, subscription management
finix-payments
v2.x
Finix payment gateway for alternative payment processing.
Tokenized payments, merchant integration
firebase-admin
v12.x
Firebase admin SDK for authentication and user management.
User creation, token verification, token revocation
@medusajs/auth-emailpass
v1.x
Email/password authentication strategy for Medusa.
Customer login, password reset, session management
Infrastructure & Storage
pg
v8.x
PostgreSQL database driver for data persistence.
Connection pooling, query execution, transaction management
ioredis
v5.x
Redis client for caching and session storage.
Cart caching, token blacklist, loyalty session cache
aws-sdk
v3.x
AWS SDK for S3 file storage and CDN integration.
Product images, customer documents, bulk exports
@sendgrid/mail
v7.x
SendGrid email service for transactional email delivery.
Order confirmations, reward notifications, account emails
Framework & Runtime
next
v15.3
React meta-framework with SSR, routing, and static generation.
Pages, API routes, file-based routing, image optimization
react
v19.1
UI library for building interactive components.
Component hierarchy, state management, effects
typescript
v5.6
TypeScript compiler for type-safe JavaScript development.
Type checking, IDE support, development-time error detection
State Management
@reduxjs/toolkit
v1.9+
Redux state management with simplified API and utilities.
Cart state, user profile, loyalty session state
react-redux
v8.x
React bindings for Redux store integration.
useSelector, useDispatch, component integration
redux-persist
v6.x
Persist Redux state to local storage across sessions.
Cart persistence, user preferences, offline capability
@tanstack/react-query
v5.x
Server state management for data fetching and caching.
API data, infinite queries, optimistic updates
UI & Styling
tailwindcss
v3.x
Utility-first CSS framework for responsive design.
Layout, typography, responsive breakpoints, dark mode
@medusajs/ui
v1.x
Pre-built UI components from Medusa ecosystem.
Forms, modals, tables, buttons, commerce components
@headlessui/react
v1.x
Unstyled, accessible UI components for custom styling.
Dropdowns, tabs, modals, menu systems
Payment & Commerce
@stripe/react-stripe-js
v2.x
Stripe React components for payment form integration.
Card elements, payment requests, checkout flow
@stripe/stripe-js
v2.x
Core Stripe JavaScript library.
Stripe API access, card validation, payment processing
Search & Analytics
@meilisearch/instant-meilisearch
v1.x
MeiliSearch integration for instant product search.
Product search, filters, real-time results
algoliasearch
v4.x
Algolia search API for advanced search and analytics.
Typo tolerance, faceting, personalization
posthog-js
v1.x
PostHog analytics for product insights and feature flags.
Event tracking, user analytics, A/B testing
@react-google-maps/api
v2.x
Google Maps API wrapper for location features.
Store locator, delivery zones, mapping
Data & Caching
PostgreSQL
v14+
Primary relational database for all application data.
Connection: medusa-db:5432
Redis
v7.x
In-memory cache for sessions, queues, and real-time data.
Connection: redis:6379
S3 Storage
AWS S3
Cloud storage for product images, documents, and exports.
Bucket: lula-direct-pdiloyalty
MeiliSearch
v1.x
Full-text search engine for product catalog and filtering.
Connection: meilisearch:7700
External APIs
PDI Conexxus API
REST v1.1
Loyalty program provider, member validation, points management.
OAuth2 + REST endpoints
Stripe API
v2024.x
Payment processing, subscriptions, refunds, webhooks.
REST API + webhooks
Finix API
REST
Alternative payment gateway for alternative payment methods.
REST API + tokenization
Firebase Auth
SDK v9
User authentication, token management, email verification.
REST API + SDKs
SendGrid
v3 API
Transactional email delivery for notifications and confirmations.
SMTP + REST API
Deployment & Infrastructure
Docker
Compose v3
Container orchestration for consistent development and production environments.
Compose v3, multi-stage builds
Nginx
v1.x
Reverse proxy, load balancing, static file serving, SSL/TLS.
Configuration: /etc/nginx/conf.d/
Node.js
v18 LTS+
JavaScript runtime for backend and CLI tooling.
v18 LTS+
npm/pnpm
Workspaces
Package management for dependencies and scripts.
Monorepo support via workspaces
Critical Path (Ordered Dependencies)
LOY-001
→
LOY-002
→
LOY-003
→
LOY-006
→
LOY-010
→
LOY-015
→
LOY-017
| Ticket | Depends On |
|---|---|
| LOY-002 | LOY-001 |
| LOY-003 | LOY-002 |
| LOY-004 | LOY-003 |
| LOY-005 | LOY-003 |
| LOY-006 | LOY-003 |
| LOY-007 | LOY-006 |
| LOY-008 | LOY-006 |
| LOY-009 | LOY-006 |
| LOY-010 | LOY-006 |
| LOY-011 | LOY-010 |
| LOY-012 | LOY-010 |
| LOY-013 | LOY-010 |
| LOY-014 | LOY-010 |
| LOY-015 | LOY-010 |
| LOY-016 | LOY-015 |
| LOY-017 | LOY-015 |