How ondc-official/seller-app-sdk works
Project type and purpose
• This is a full-stack, microservices-based Seller App for ONDC (Open Network for Digital Commerce).
• It provides a React frontend, multiple backend microservices (Node.js and Python), and infrastructure components (Nginx, Docker, Ansible) to manage seller order fulfillment, catalog, tracking, notifications, and integration with ONDC protocol and third-party services.
File structure
• Top-level infra & config:
• Docker Compose files for local/dev/production (docker-compose-for-local.yaml, docker-compose-with-images.yaml, etc.)
• bpp-nginx/ submodule: nginx config, Dockerfiles, serves the React app
• deploying_ansible/: Ansible playbooks and hosts for prod deployment & SSL provisioning
• init-letsencrypt.sh: bootstraps Let’s Encrypt certificates
• Core microservices (each a Git submodule):
• seller-app/: Node.js REST API handling business logic
• seller-app-frontend/: React UI served via Nginx
• seller-app-protocol/: Python service implementing ONDC protocol messaging
• seller-app-igm/: Node.js IGM layer for gateway interactions
• seller-bugzilla-service/: Node.js service for Bugzilla integration
• Ancillary artifacts: .env.example, .gitmodules, assets/
Key insights from README
• Microservice architecture with clear separation: frontend, API, protocol layer, gateway integration, Bugzilla integration
• External dependencies: Firebase Authentication, SMTP, AWS S3 (assets), MapMyIndia (geocoding), ONDC registry/gateway, ngrok for local tunneling
• Deploys via Docker Compose (for local) and Ansible + Docker (for staging/prod) with automated SSL