remotion-dev/remotion · error · Error

/ has files. Browser Studio supports up to .

Error message

${owner}/${repo} has ${fileEntries.length.toLocaleString()} files. Browser Studio supports up to ${maximumRepositoryFiles.toLocaleString()}.

What it means

After filtering the GitHub tree to blobs, loadGitHubRepository enforces maximumRepositoryFiles = 2_000. A repository with more tracked files than that is rejected with the exact count and the limit in the message. The check runs after per-path validation but before any bytes are downloaded.

Solutions

  1. Reduce the repository to 2,000 tracked files or fewer (remove build output, vendored deps, unused assets)
  2. Point Browser Studio at a slim template repo instead of a large monorepo
  3. Check the count beforehand with: git ls-files | wc -l
Defensive patterns

Strategy: try-catch

Try / catch

try {
  await loadGitHubRepository({repoUrl, onProgress});
} catch (e) {
  const msg = String((e as Error).message);
  if (/supports up to/.test(msg)) {
    // the message contains the actual count; guide the user to prune below 2,000 files
  } else throw e;
}

Prevention

When it happens

Trigger: Calling loadGitHubRepository on a repository whose tree contains more than 2,000 blob entries - e.g. committed node_modules, build artifacts, or an asset-heavy project; fileEntries.length > maximumRepositoryFiles triggers the throw.

Common situations: Monorepos; repos with generated output checked in; design-heavy projects with thousands of images; users expecting a full app repository to load into a browser sandbox.

Related errors


AI-assisted analysis of remotion-dev/remotion@10db9de073 (2026-08-22). Data as JSON: /api/errors/4c0db5fb0ec3d933. Report an issue: GitHub.

Appendix: source

Thrown at packages/browser-studio/src/load-github-repository.ts:176

	}

	const treeSha = tree.sha;

	if (tree.truncated) {
		throw new Error(
			`${owner}/${repo} has too many files for Browser Studio to load.`,
		);
	}

	const fileEntries = tree.tree.filter(
		(entry): entry is GitHubTreeEntry & {type: 'blob'} => entry.type === 'blob',
	);
	for (const file of fileEntries) {
		validateRepositoryPath(file.path);
	}

	if (fileEntries.length > maximumRepositoryFiles) {
		throw new Error(
			`${owner}/${repo} has ${fileEntries.length.toLocaleString()} files. Browser Studio supports up to ${maximumRepositoryFiles.toLocaleString()}.`,
		);
	}

	const totalBytes = fileEntries.reduce(
		(total, entry) => total + (entry.size ?? 0),
		0,
	);
	if (totalBytes > maximumRepositoryBytes) {
		throw new Error(
			`${owner}/${repo} is larger than the 100 MB Browser Studio limit.`,
		);
	}

	let loadedBytes = 0;
	let loadedFiles = 0;
	const files: Record<string, string> = {};
	const publicFiles: Record<string, VirtualProjectPublicFile> = {};

View on GitHub (pinned to 10db9de073)