{"record":{"id":"e9a8ff805d60fd35","repo":"remotion-dev/remotion","slug":"the-experimental-rspack-flag-has-been-removed-u","errorCode":null,"errorMessage":"The --experimental-rspack flag has been removed. Use --rspack from now on.","messagePattern":"The --experimental-rspack flag has been removed\\. Use --rspack from now on\\.","errorType":"validation","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"packages/cli/src/parse-command-line.ts","lineNumber":9,"sourceCode":"import {BrowserSafeApis} from '@remotion/renderer/client';\nimport {Config} from './config';\nimport {parsedCli} from './parsed-cli';\n\nconst {licenseKeyOption} = BrowserSafeApis.options;\n\nexport const parseCommandLine = () => {\n\tif (parsedCli['experimental-rspack'] !== undefined) {\n\t\tthrow new Error(\n\t\t\t'The --experimental-rspack flag has been removed. Use --rspack from now on.',\n\t\t);\n\t}\n\n\tif (parsedCli.png) {\n\t\tthrow new Error(\n\t\t\t'The --png flag has been removed. Use --sequence --image-format=png from now on.',\n\t\t);\n\t}\n\n\tconst {value: licenseKey, source} = licenseKeyOption.getValue({\n\t\tcommandLine: parsedCli,\n\t});\n\tif (source === 'cli' && licenseKey?.startsWith('rm_pub_')) {\n\t\tConfig.setPublicLicenseKey(licenseKey);\n\t}\n};\n","sourceCodeStart":1,"sourceCodeEnd":27,"githubUrl":"https://github.com/remotion-dev/remotion/blob/78fe4bb3fdb5a2cd68724393d63cb223db333fa7/packages/cli/src/parse-command-line.ts#L1-L27","documentation":"Thrown by parseCommandLine if the legacy --experimental-rspack flag is present. Rspack support graduated from experimental, so the flag was renamed to --rspack and the old form is hard-rejected to force users onto the stable name.","triggerScenarios":"Invoking any CLI command with `--experimental-rspack` on the command line or in an npm script.","commonSituations":"Scripts/docs from when Rspack was experimental; copy-pasting an old `remotion render --experimental-rspack` invocation; CI YAML that has not been updated.","solutions":["Replace `--experimental-rspack` with `--rspack`.","Update any npm scripts, CI configs, and documentation that reference the old flag.","If you do not need Rspack, simply remove the flag."],"exampleFix":"// before\n$ npx remotion render MyComp out.mp4 --experimental-rspack\n// after\n$ npx remotion render MyComp out.mp4 --rspack","handlingStrategy":"validation","validationCode":"const ensureNoLegacyRspack = (argv: string[]) => {\n  if (argv.includes('--experimental-rspack')) {\n    throw new Error('Use --rspack instead of the removed --experimental-rspack');\n  }\n};\n\nensureNoLegacyRspack(process.argv);","typeGuard":"const usesRspackFlag = (argv: string[]): boolean =>\n  argv.includes('--rspack');","tryCatchPattern":null,"preventionTips":["Grep your repo for --experimental-rspack and migrate all occurrences.","Update internal docs and CI YAMLs when flags graduate from experimental."],"tags":["cli","rspack","deprecated-flag","migration"],"backgroundTag":null,"analyzedSha":"78fe4bb3fdb5a2cd68724393d63cb223db333fa7","analyzedAt":"2026-08-12T17:18:50.444Z","schemaVersion":2},"datasetVersion":"2026-08-12T18:17:37.767Z"}