Rogen IconRogen
Guides

Tags

Step-by-step setup guide to tag filtering.

Tags filter test files, mock data, and development scripts from production builds. Rogen drops inactive files and strips active tags from file names.

Configure Modes

Open the .rogen.json configuration file. Create separate build modes for development and production. Add a tags object inside each mode. Assign true to active tags. Assign false to inactive tags.

.rogen.json
{
	"source": ["src"],
	"luau-dev": {
		"output": "dev.project.json",
		"build": "src",
		"tags": {
			"dev": true,
			"prod": false
		}
	},
	"luau-prod": {
		"output": "prod.project.json",
		"build": "src",
		"tags": {
			"dev": false,
			"prod": true
		}
	}
}

Build the Project

Run Rogen via the CLI. Specify the target mode using the -m or --mode flag.

rogen watch -m luau-dev

Because the luau-dev mode is used, any item containing prod will be completely dropped.

CLI Overrides

Override configured tags via the CLI using the -t or --tag flag (e.g. rogen watch -m luau-prod -t debug)

On this page