# Open-SEO Repository Root File Sizes: Complete Breakdown of Every Top-Level File

> Discover the complete breakdown of every top-level file size in the open-seo repository root. Learn which files are largest and smallest for efficient project management.

- Repository: [Every App/open-seo](https://github.com/every-app/open-seo)
- Tags: performance
- Published: 2026-09-11

---

**The open-seo repository root contains 30+ files ranging from 1 KB to 15 KB, with [`package.json`](https://github.com/every-app/open-seo/blob/main/package.json) being the largest at approximately 15 KB.**

The **every-app/open-seo** repository maintains a lean root directory where configuration files, documentation, and build scripts total under 100 KB combined. Understanding these **open-seo repository root file sizes** helps contributors grasp the project's lightweight architecture and identify which files handle critical build and deployment logic. All measurements below reflect the current `main` branch on GitHub, with sizes rounded to the nearest kilobyte for readability.

## Complete Inventory of Root File Sizes

The repository root houses a mix of configuration files, environment templates, and documentation. Below is the complete inventory of file sizes derived from the GitHub API byte counts:

| File | Approximate Size |
|------|------------------|
| [`package.json`](https://github.com/every-app/open-seo/blob/main/package.json) | 15 KB |
| [`README.md`](https://github.com/every-app/open-seo/blob/main/README.md) | 7 KB |
| [`vite.config.ts`](https://github.com/every-app/open-seo/blob/main/vite.config.ts) | 6 KB |
| [`AGENTS.md`](https://github.com/every-app/open-seo/blob/main/AGENTS.md) | 5 KB |
| [`CLAUDE.md`](https://github.com/every-app/open-seo/blob/main/CLAUDE.md) | 4 KB |
| [`tsconfig.json`](https://github.com/every-app/open-seo/blob/main/tsconfig.json) | 3 KB |
| `wrangler.jsonc` | 2 KB |
| `wrangler.audit.jsonc` | 2 KB |
| [`worker-configuration.d.ts`](https://github.com/every-app/open-seo/blob/main/worker-configuration.d.ts) | 2 KB |
| [`docker-entrypoint.sh`](https://github.com/every-app/open-seo/blob/main/docker-entrypoint.sh) | 2 KB |
| [`playwright.config.ts`](https://github.com/every-app/open-seo/blob/main/playwright.config.ts) | 2 KB |
| `Dockerfile.selfhost` | 2 KB |
| [`cli-auth.ts`](https://github.com/every-app/open-seo/blob/main/cli-auth.ts) | 2 KB |
| `LICENSE` | 1 KB |
| [`opencode.json`](https://github.com/every-app/open-seo/blob/main/opencode.json) | 1 KB |
| `knip.jsonc` | 1 KB |
| [`compose.yaml`](https://github.com/every-app/open-seo/blob/main/compose.yaml) | 1 KB |
| [`ChatGPT-app-submission.json`](https://github.com/every-app/open-seo/blob/main/ChatGPT-app-submission.json) | 1 KB |
| `.gitignore` | 1 KB |
| [`.vscode/settings.json`](https://github.com/every-app/open-seo/blob/main/.vscode/settings.json) | 1 KB |
| `.env.example` | 1 KB |
| `.env.production.example` | 1 KB |
| `.env.preview.example` | 1 KB |
| `.env.selfhost.example` | 1 KB |
| [`.greptile/config.json`](https://github.com/every-app/open-seo/blob/main/.greptile/config.json) | 1 KB |
| [`.greptile/files.json`](https://github.com/every-app/open-seo/blob/main/.greptile/files.json) | 1 KB |
| [`.greptile/rules.md`](https://github.com/every-app/open-seo/blob/main/.greptile/rules.md) | 1 KB |
| `.npmrc` | < 1 KB |
| `.prettierignore` | < 1 KB |
| [`.oxlintrc.json`](https://github.com/every-app/open-seo/blob/main/.oxlintrc.json) | < 1 KB |
| `.dockerignore` | < 1 KB |

These modest sizes reflect the repository's design philosophy favoring readability and maintainability over complex, multi-kilobyte configurations.

## Largest Files and Their Purpose

While most root files remain under 5 KB, several entries exceed this threshold and serve critical architectural functions:

- **[`package.json`](https://github.com/every-app/open-seo/blob/main/package.json)** (15 KB): Contains the complete dependency manifest for both production and development environments, including scripts for building and deploying the Cloudflare Worker.

- **[`README.md`](https://github.com/every-app/open-seo/blob/main/README.md)** (7 KB): Provides the introductory documentation and quick-start guide for new contributors and users.

- **[`vite.config.ts`](https://github.com/every-app/open-seo/blob/main/vite.config.ts)** (6 KB): Defines the Vite build configuration responsible for front-end UI bundling and worker compilation.

- **[`AGENTS.md`](https://github.com/every-app/open-seo/blob/main/AGENTS.md)** (5 KB) and **[`CLAUDE.md`](https://github.com/every-app/open-seo/blob/main/CLAUDE.md)** (4 KB): House engineering guidelines and agent behavior protocols for AI-assisted development workflows.

## Programmatically Retrieving File Sizes

You can verify these **open-seo repository root file sizes** dynamically using the GitHub REST API. The following TypeScript function demonstrates how to fetch the byte size of any file in the repository:

```typescript
import fetch from 'node-fetch';

async function fileSize(path: string) {
  const res = await fetch(
    `https://api.github.com/repos/every-app/open-seo/contents/${path}?ref=main`,
    { headers: { Accept: 'application/vnd.github.v3+json' } }
  );
  const data = await res.json();
  return data.size; // size in bytes
}

// Retrieve all root-level file sizes
(async () => {
  const files = [
    'README.md',
    'LICENSE',
    'package.json',
    // … add other root files as needed
  ];
  for (const f of files) {
    console.log(`${f}: ${await fileSize(f)} bytes`);
  }
})();

```

This approach queries the `size` property returned by the GitHub API for each file object in the repository contents.

## Configuration Files by Function

Understanding which files govern specific aspects of the system helps prioritize what to examine:

- **Build & Bundle**: [`vite.config.ts`](https://github.com/every-app/open-seo/blob/main/vite.config.ts) (6 KB) and [`tsconfig.json`](https://github.com/every-app/open-seo/blob/main/tsconfig.json) (3 KB) manage the TypeScript compilation and asset bundling pipeline.

- **Deployment**: `wrangler.jsonc` and `wrangler.audit.jsonc` (2 KB each) define Cloudflare Worker routes, KV bindings, and environment variables for production and audit contexts.

- **Type Definitions**: [`worker-configuration.d.ts`](https://github.com/every-app/open-seo/blob/main/worker-configuration.d.ts) (2 KB) provides TypeScript type safety for the Cloudflare Worker runtime environment.

- **Code Quality**: `knip.jsonc` (1 KB) tracks unused dependencies, while [`.oxlintrc.json`](https://github.com/every-app/open-seo/blob/main/.oxlintrc.json) (< 1 KB) configures linting rules.

- **Containerization**: `Dockerfile.selfhost` (2 KB) and [`docker-entrypoint.sh`](https://github.com/every-app/open-seo/blob/main/docker-entrypoint.sh) (2 KB) enable self-hosted deployments outside Cloudflare's infrastructure.

## Summary

- The **open-seo** repository root maintains a deliberately small footprint, with all files totaling approximately 70-80 KB.
- **[`package.json`](https://github.com/every-app/open-seo/blob/main/package.json)** dominates the root at 15 KB, reflecting extensive dependency management and build scripts.
- Documentation files ([`README.md`](https://github.com/every-app/open-seo/blob/main/README.md), [`AGENTS.md`](https://github.com/every-app/open-seo/blob/main/AGENTS.md), [`CLAUDE.md`](https://github.com/every-app/open-seo/blob/main/CLAUDE.md)) comprise 16 KB combined, emphasizing the project's focus on comprehensive guidance.
- Configuration files follow a strict small-file philosophy, with most weighing 1-3 KB to ensure rapid parsing and easy manual editing.
- The GitHub API exposes these sizes via the `size` property on repository content endpoints, enabling automated monitoring.

## Frequently Asked Questions

### What is the largest file in the open-seo repository root?

The **[`package.json`](https://github.com/every-app/open-seo/blob/main/package.json)** file is the largest at approximately 15 KB. This file contains the full dependency tree for the Node.js environment, including development tools like TypeScript, Vite, and testing frameworks that support the build pipeline.

### How can I check open-seo repository root file sizes programmatically?

Use the GitHub REST API endpoint `https://api.github.com/repos/every-app/open-seo/contents/{path}` with the header `Accept: application/vnd.github.v3+json`. The response includes a `size` field representing the file size in bytes, which you can fetch using any HTTP client or the `fileSize` function implementation shown above.

### Why are most configuration files in the open-seo root under 5 KB?

The repository follows a **lean design philosophy** that prioritizes human readability and maintainability. By keeping configuration files small—such as `wrangler.jsonc` at 2 KB and `knip.jsonc` at 1 KB—the project ensures developers can quickly scan and modify settings without navigating through verbose boilerplate or generated code.

### Which root files are essential for deploying the open-seo application?

Three files are critical for deployment: **`wrangler.jsonc`** defines the Cloudflare Worker configuration and bindings, **[`vite.config.ts`](https://github.com/every-app/open-seo/blob/main/vite.config.ts)** handles the build bundling, and **[`worker-configuration.d.ts`](https://github.com/every-app/open-seo/blob/main/worker-configuration.d.ts)** ensures type safety for the production environment. For self-hosted deployments, **`Dockerfile.selfhost`** and **[`docker-entrypoint.sh`](https://github.com/every-app/open-seo/blob/main/docker-entrypoint.sh)** provide the containerization logic.