Skip to content
@mindstellar

Mindstellar

Open-source, self-hosted, free classifieds: Shopclass and its ecosystem.
Mindstellar: open-source classifieds you run on your own hosting.

Website  ·  Docs  ·  Live demo  ·  Download  ·  Coming from Osclass?

Our goal

Anyone should be able to run a classifieds marketplace they fully own: on ordinary hosting, with no licence fees, no lock-in, and extensions that keep working after an upgrade.

Self-hosted first
A zip you upload to shared hosting or a VPS. No build step, no required cloud service.
Upgrades that don't break sites
The osc_* helpers, hooks and admin classes are treated as a public API.
Open by default
Code under GPL-3.0. Location data under CC0. Plugin and theme catalogues are public repositories.
Modern, not rewritten
PHP 8, jQuery-free core, a rebuilt admin. Your Osclass data and extensions come with you.

Shopclass

Stable release Beta release Tests PHP 8.0+ GPL-3.0 Stars

Shopclass is a free, self-hosted classifieds CMS in PHP, and the maintained successor to Osclass. Run a site for jobs, property, vehicles or anything else.

  • Listings with photos, categories, custom fields and locations
  • Search, filters and SEO-friendly URLs
  • User accounts, moderation, spam and report handling
  • Paid listings and packages
  • A rebuilt, accessible admin panel
  • A one-click updater, and plugins and themes you install from the admin

The ecosystem

The Shopclass core with its themes, plugins, translations, location data and registries.

Themes

Repository What it does Version
theme-storefront The default theme. Vanilla JS, light and dark, three WCAG-AA palettes.
theme-folio A minimal theme on native HTML5. Logo, brand colour and footer settings.

Plugins

Repository What it does Version
shopclass-plugin-cloudflare Purges the Cloudflare cache when content changes. Cache rules and analytics in the admin.
shopclass-plugin-nginx-cache Holds pages in the nginx cache, and purges them when a listing changes.
shopclass-plugin-digital-goods Attaches downloadable files to a listing, stored privately behind a gated link.

Registries

Repository What it does
shopclass-plugins The plugin registry. Submit a plugin by pull request; it appears in every admin's catalogue.
shopclass-themes The theme registry. Browse, install and update themes from the admin.

Translations and data

Repository What it does
shopclass-i18n Every language Shopclass ships in. A merged translation reaches sites without a new release.
location-data Countries, regions and 1.6M+ places from Wikidata, published CC0, with the pipeline that builds it.

How it is built

  • Code under GPL-3.0, in public repositories.
  • Tests run on every push.
  • Releases are built by CI from a tagged commit, each with a changelog.
  • Security reports go through private vulnerability reporting.
  • Sites upgrade from Osclass 3.x and 5.x; see the upgrade guide.

Get involved


Mindstellar is the open-source work of Navjot Tomer, with contributions from the people who run Shopclass.

Pinned Loading

  1. shopclass shopclass Public

    ShopClass — a free, self-hosted, open-source classifieds CMS in PHP. The modernised successor to Osclass.

    PHP 104 53

  2. shopclass-themes shopclass-themes Public

    Theme registry for Shopclass. Themes register their own repository or are hosted here, and are published as a static catalog that powers browse, install and updates inside the admin.

    Shell

  3. shopclass-plugins shopclass-plugins Public

    Plugin registry for Shopclass. Packages are submitted by pull request and published as a static catalog that powers browse, install and updates inside the admin.

    PHP

  4. theme-storefront theme-storefront Public

    Storefront — the default public theme for Shopclass classifieds. Vanilla JS, light/dark, three WCAG-AA colour palettes, admin settings backend.

    PHP

  5. location-data location-data Public

    A CC0 worldwide dataset of countries, administrative divisions and 1.6M+ settlements, built from Wikidata — and the pipeline that builds it.

    Python

  6. shopclass-i18n shopclass-i18n Public

    Translations for Shopclass

    JavaScript 1

Repositories

Showing 10 of 21 repositories
  • shopclass-plugins Public

    Plugin registry for Shopclass. Packages are submitted by pull request and published as a static catalog that powers browse, install and updates inside the admin.

    mindstellar/shopclass-plugins's past year of commit activity
    PHP 0 GPL-3.0 0 0 0 Updated Sep 15, 2026
  • shopclass-themes Public

    Theme registry for Shopclass. Themes register their own repository or are hosted here, and are published as a static catalog that powers browse, install and updates inside the admin.

    mindstellar/shopclass-themes's past year of commit activity
    Shell 0 GPL-3.0 0 0 0 Updated Sep 15, 2026
  • shopclass Public

    ShopClass — a free, self-hosted, open-source classifieds CMS in PHP. The modernised successor to Osclass.

    mindstellar/shopclass's past year of commit activity
    PHP 104 GPL-3.0 53 1 2 Updated Sep 15, 2026
  • .github Public

    Mindstellar organization profile

    mindstellar/.github's past year of commit activity
    0 0 0 0 Updated Sep 15, 2026
  • theme-folio Public

    Folio — a minimal Shopclass public theme built on native HTML5. Requires Shopclass 6.3.0+. Reference implementation of the theme chrome contract.

    mindstellar/theme-folio's past year of commit activity
    PHP 0 0 0 0 Updated Sep 15, 2026
  • shopclass-plugin-nginx-cache Public

    nginx cache plugin for Shopclass: hold pages for an hour instead of thirty seconds, and purge them the moment a listing changes.

    mindstellar/shopclass-plugin-nginx-cache's past year of commit activity
    PHP 0 GPL-3.0 0 0 0 Updated Sep 15, 2026
  • shopclass-plugin-digital-goods Public

    Digital Goods — attach downloadable files to a Shopclass listing, stored privately and served through a gated link.

    mindstellar/shopclass-plugin-digital-goods's past year of commit activity
    PHP 0 GPL-3.0 0 0 0 Updated Sep 15, 2026
  • shopclass-plugin-cloudflare Public

    Cloudflare integration for Shopclass: automatic cache purge on content changes, one-click cache rules, and a cache-analytics widget.

    mindstellar/shopclass-plugin-cloudflare's past year of commit activity
    PHP 0 GPL-3.0 0 0 0 Updated Sep 15, 2026
  • theme-storefront Public

    Storefront — the default public theme for Shopclass classifieds. Vanilla JS, light/dark, three WCAG-AA colour palettes, admin settings backend.

    mindstellar/theme-storefront's past year of commit activity
    PHP 0 0 0 0 Updated Sep 15, 2026
  • shopclass-i18n Public

    Translations for Shopclass

    mindstellar/shopclass-i18n's past year of commit activity
    JavaScript 0 GPL-3.0 1 0 2 Updated Sep 14, 2026