Skip to content

Shop3 Theme Documentation

Shop3 is an OpenCart 3-first theme project with a long-term goal of becoming a free, community-informed frontend platform for OpenCart stores.

English documentation is the source of truth. Russian documentation in docs/ru/ is translation only and must not introduce independent architecture decisions.

Current Priorities

  • OpenCart 3-first theme architecture.
  • Future OpenCart 4 compatibility boundaries.
  • Canonical OpenCart conventions.
  • A coherent documentation system reviewed through PRs.
  • A public static documentation site generated from GitHub /docs.

Start Here

  • docs/roadmap.md - phases and current focus.
  • docs/architecture.md - high-level architecture overview.
  • docs/documentation-map.md - full documentation map and translation status.
  • docs/naming-conventions.md - canonical shop3 and shop3_ naming rules.
  • docs/theme-settings-engine.md - approved settings engine architecture.
  • docs/development-workflow.md - branch, PR, review, and merge workflow.

Public Site

The public documentation site is planned for https://docs.opencart.link/. It is generated output; GitHub /docs remains the source of truth.