chore: quick wins from OSS audit (#203, #204, #211, #212)

AGENTS.md

@@ -2,10 +2,10 @@
 
 ## Component-Specific Setup
 
-Each component has its own AGENTS.md with setup details:
-- **extralit-server/AGENTS.md** - Backend server setup
-- **extralit-frontend/AGENTS.md** - Frontend UI setup
-- **extralit/AGENTS.md** - Python SDK setup
+Each component has its own `CLAUDE.md` with setup details:
+- **extralit-server/CLAUDE.md** - Backend server setup
+- **extralit-frontend/CLAUDE.md** - Frontend UI setup
+- **extralit/CLAUDE.md** - Python SDK setup
 
 ## Prerequisites
 

CONTRIBUTING.md

@@ -37,6 +37,15 @@ The contributor guide covers:
 
 ## Development setup
 
-Refer to our [development setup documentation](https://docs.extralit.ai/latest/getting_started/development_setup/) for instructions on setting up your local environment.
+Refer to our [development setup documentation](https://docs.extralit.ai/latest/getting_started/development_setup/) for instructions on setting up your local environment, and the per-component `CLAUDE.md` files (`extralit-server/CLAUDE.md`, `extralit-frontend/CLAUDE.md`, `extralit/CLAUDE.md`) for component-specific commands.
+
+### Choose a dev environment
+
+Pick the environment that matches what you're working on:
+
+- **Tilt** (`Tiltfile`) — Recommended for active full-stack development. Brings up server + frontend + dependencies with live reload. Use this when iterating on backend and frontend together.
+- **`docker-compose.yaml`** — Quickest way to run a complete stack against fixed images. Use when you need a reproducible environment to demo or test against, but don't need code-level reload.
+- **`examples/deployments/k8s/`** — Reference manifests for production-style Kubernetes deployments. Use as a starting point for staging/prod, not for local iteration.
+- **Bare `uv sync` + `npm run dev`** — Fastest inner loop when only one component is in scope. See the per-component `CLAUDE.md` files.
 
 Thank you for contributing to Extralit! 🚀

README.md

@@ -47,7 +47,7 @@ pip install extralit
 
 If you already have a server deployed and login credentials, obtain your API key in the User Settings. You can manage your extraction workspace through the CLI with:
 
-```base
+```bash
 extralit login --api-url http://<extralit_server_instance>
 # You will be prompted an API key to login to your account
 ```

examples/README.md

@@ -0,0 +1,12 @@
+# Examples
+
+End-to-end snippets for using Extralit. Each subdirectory targets a specific feature or deployment scenario.
+
+| Example | Component | What it shows |
+|---|---|---|
+| [custom_field](custom_field) | SDK / frontend | Custom field types — interactive chat (`interactive_chat.html`), and table fields (`table_field.ipynb`). |
+| [deployments](deployments) | Server | Reference [Docker](deployments/docker) and [Kubernetes](deployments/k8s) deployment configs. See [deployments/README.md](deployments/README.md). |
+| [document_extraction](document_extraction) | SDK | Notebook walkthrough for setting up a workspace and running extraction (`setup_workspace.ipynb`). |
+| [webhooks](webhooks) | Server | Minimal webhooks integration ([basic-webhooks](webhooks/basic-webhooks)). |
+
+Notebooks assume a running Extralit server and SDK install — see the root [README.md](../README.md) and [AGENTS.md](../AGENTS.md) for setup.

extralit-frontend/.eslintrc.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/arrow-down.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/arrow-up.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/assign.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/bulk-mode.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/change-height.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/check.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/chevron-down.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/chevron-left.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/chevron-right.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/chevron-up.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/clear.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/close.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/code.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/copy.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/danger.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/dark-theme.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/discard.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/draggable.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/expand-arrows.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/exploration.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/export.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/external-link.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/external.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/filter.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/focus-mode.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/hand-labeling.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/high-contrast-theme.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/import.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/info.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/kebab.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/light-theme.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/link.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/log-out.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/matching.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/math-plus.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/meatballs.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/minimize-arrows.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/no-matching.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/pen.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/plus.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/progress.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

extralit-frontend/assets/icons/question-answering.js

@@ -1,6 +1,6 @@
 /*
  * coding=utf-8
- * Copyright 2021-present, the Recognai S.L. team.
+ * Copyright 2024-present, Extralit Labs, Inc..
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.