Stackable/.cursor/rules/project-repos.mdc at develop · gambitph/Stackable · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
---
description: Stackable project GitHub repos, roadmap, and free/premium structure
alwaysApply: true
---

# Stackable Project & Repositories

## Release Roadmap

The issues list, organized by targeted release version number, is the **Stackable Release Roadmap**:
https://github.com/orgs/gambitph/projects/2/views/1

## Repositories

This project has two GitHub repositories, used depending on whether we're building the **free** or **premium** version of Stackable.

### Free version

- Main plugin repo: https://github.com/gambitph/Stackable
- Contains **only** free plugin code and must remain free of premium logic (WordPress.org guidelines).
- Must pass [WordPress Plugin Check](https://github.com/wordpress/plugin-check) for Plugin Directory inclusion (see `wordpress-plugin-check` rule).

### Premium version

- Uses the free version as the main plugin repo, and additionally uses:
- Premium-only repo: https://github.com/bfintal/Stackable-Premium
- The premium repo contains **only** the premium plugin code.
- It is placed in the `pro__premium_only` directory inside the free plugin's root folder.

## Free / Premium boundaries

- Do not put premium feature logic in the free repo.
- Premium code lives exclusively under `pro__premium_only/`.
- The free plugin may gate-load premium via `STACKABLE_BUILD === 'premium'` and `pro__premium_only/index.php` (with Freemius `sugb_fs()->is__premium_only()`).
- When packaging the free build, `pro__premium_only` must not be included.