{"record":{"id":"aa49fb0f2a5ea80a","repo":"remotion-dev/remotion","slug":"checkerboard-program-link-failed-log-no-lo","errorCode":null,"errorMessage":"Checkerboard program link failed: ${log ?? '(no log)'}","messagePattern":"Checkerboard program link failed: (.+?)","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"packages/effects/src/checkerboard.ts","lineNumber":309,"sourceCode":"};\n\nconst linkProgram = (\n\tgl: WebGL2RenderingContext,\n\tvs: WebGLShader,\n\tfs: WebGLShader,\n): WebGLProgram => {\n\tconst program = gl.createProgram();\n\tif (!program) {\n\t\tthrow new Error('Failed to create WebGL program');\n\t}\n\n\tgl.attachShader(program, vs);\n\tgl.attachShader(program, fs);\n\tgl.linkProgram(program);\n\tif (!gl.getProgramParameter(program, gl.LINK_STATUS)) {\n\t\tconst log = gl.getProgramInfoLog(program);\n\t\tgl.deleteProgram(program);\n\t\tthrow new Error(`Checkerboard program link failed: ${log ?? '(no log)'}`);\n\t}\n\n\treturn program;\n};\n\nconst createProgram = (\n\tgl: WebGL2RenderingContext,\n\tvertexSource: string,\n\tfragmentSource: string,\n): WebGLProgram => {\n\tconst vs = compileShader(gl, gl.VERTEX_SHADER, vertexSource);\n\tconst fs = compileShader(gl, gl.FRAGMENT_SHADER, fragmentSource);\n\tconst program = linkProgram(gl, vs, fs);\n\tgl.deleteShader(vs);\n\tgl.deleteShader(fs);\n\treturn program;\n};\n","sourceCodeStart":291,"sourceCodeEnd":327,"githubUrl":"https://github.com/remotion-dev/remotion/blob/78fe4bb3fdb5a2cd68724393d63cb223db333fa7/packages/effects/src/checkerboard.ts#L291-L327","documentation":"Thrown by linkProgram() for the checkerboard effect when the vertex and fragment shaders both compiled but gl.linkProgram() failed (LINK_STATUS false). The message embeds the program info log. For the shipped static shaders this normally reflects a driver bug, a varying/uniform mismatch introduced by a driver's GLSL ES 3.00 implementation, or a degraded context rather than a source defect.","triggerScenarios":"gl.linkProgram() at checkerboard.ts:305 completes but gl.getProgramParameter(LINK_STATUS) is false at :306; the info log is read, the program deleted, and the error at :309 is thrown with the log.","commonSituations":"Outdated/buggy GPU drivers, software rasterizers with incomplete GLSL ES 3.00 linkers, GPUs on the browser's blocklist, or a corrupted build of @remotion/effects altering shader sources.","solutions":["Read the embedded info log to see the linker's complaint (e.g. unresolved varying, location clash).","Update GPU drivers to the latest stable version.","Switch to a GPU-accelerated renderer (disable software fallback).","Upgrade @remotion/effects to ensure the shipped shaders are intact.","Reproduce in Chrome for Testing on different hardware to confirm a driver-specific issue."],"exampleFix":null,"handlingStrategy":"try-catch","validationCode":null,"typeGuard":null,"tryCatchPattern":"try {\n  return <Checkerboard {...props} />;\n} catch (err) {\n  const msg = String(err);\n  if (/Checkerboard program link failed/.test(msg)) {\n  reportShaderError(msg);\n  return <FallbackFrame />;\n  }\n  throw err;\n}","preventionTips":["Update GPU drivers; link failures on shipped, compiling shaders are typically driver bugs.","Avoid blocklisted GPUs / broken software fallbacks.","Keep @remotion/effects at a verified version.","Reproduce on different hardware to isolate driver-specific linkers."],"tags":["webgl","glsl","program","gpu","driver-bug","effects","checkerboard","rendering"],"backgroundTag":null,"analyzedSha":"78fe4bb3fdb5a2cd68724393d63cb223db333fa7","analyzedAt":"2026-08-12T17:18:50.444Z","schemaVersion":2},"datasetVersion":"2026-08-12T18:17:37.767Z"}