Use Claude Code, Codex, VSCode, Pi, and OpenCode (and 6 other harnesses) for free (1.3B+ free tokens) from your terminal, app, IDE, or phone, and now from the browser with native browser sessions (multi-harness + multi-model) like OpenClaw (voice supported + ToS friendly)
Python
"""Rendered contracts for Admin asset generation consistency."""
from urllib.parse import urlsplit
import pytest
from playwright.sync_api import Error, Page, Request, expect
from e2e.form_support import assert_autofill_opt_out
from e2e.provider_support import api_key_input, open_provider
from free_claude_code.core.version import package_version
@pytest.mark.parametrize("width", [1280, 900, 390])
def test_admin_page_spacing_matches_visible_action_bar(page, admin_base_url, width):
page.set_viewport_size({"width": width, "height": 720})
page.goto(f"{admin_base_url}/admin")
expect(page.locator("#messageArea")).to_have_text("")
def assert_spacing():
page.wait_for_function("""() => !document.querySelector('.action-bar')
.getAnimations({subtree: true}).some(animation => animation.playState === 'running')""")
# Wait for layout/ResizeObserver delivery, then inspect rendered geometry.
page.evaluate(
"() => new Promise(resolve => requestAnimationFrame(() => requestAnimationFrame(resolve)))"
)
measurements = page.evaluate("""() => {
const main = document.querySelector('.main');
const style = getComputedStyle(main);
const bar = document.querySelector('.action-bar');
const last = document.querySelector('.admin-view:not([hidden]) .form-sections > :last-child');
const heading = document.querySelector('#pageTitle');
const range = document.createRange();
range.selectNodeContents(heading);
const text = range.getBoundingClientRect();
const context = document.createElement('canvas').getContext('2d');
context.font = getComputedStyle(heading).font;
const metrics = context.measureText(heading.textContent);
const inkTop = text.top + (text.height - metrics.fontBoundingBoxAscent - metrics.fontBoundingBoxDescent) / 2
+ metrics.fontBoundingBoxAscent - metrics.actualBoundingBoxAscent;
return {
top: parseFloat(style.paddingTop),
bottom: parseFloat(style.paddingBottom),
bar: bar.getBoundingClientRect().height,
endGap: last ? main.getBoundingClientRect().bottom - last.getBoundingClientRect().bottom : null,
headingGap: inkTop - main.getBoundingClientRect().top,
};
}""")
assert measurements["bottom"] - measurements["bar"] == pytest.approx(
measurements["top"], abs=1
)
# Ink can overshoot the font's cap metric; allow pixel rounding as well.
assert measurements["headingGap"] == pytest.approx(measurements["top"], abs=2)
if measurements["endGap"] is not None:
assert measurements["endGap"] - measurements["bar"] == pytest.approx(
measurements["top"], abs=1
)
for title in ("Providers", "Model Config", "Messaging"):
page.get_by_role("button", name=title, exact=True).click()
expect(page.locator("#pageTitle")).to_have_text(title)
assert_spacing()
original_height = page.locator(".action-bar").bounding_box()["height"]
page.locator("#messageArea").evaluate(
"node => node.textContent = 'A longer validation message that wraps onto multiple lines. '.repeat(20)"
)
assert_spacing()
assert page.locator(".action-bar").bounding_box()["height"] > original_height
page.set_viewport_size({"width": 700 if width > 900 else 1200, "height": 720})
assert_spacing()
page.get_by_role("button", name="Integrations", exact=True).click()
expect(page.locator(".action-bar")).to_be_hidden()
assert_spacing()
page.get_by_role("button", name="Providers", exact=True).click()
expect(page.locator(".action-bar")).to_be_visible()
assert_spacing()
def test_settings_text_fields_opt_out_of_autofill(page, admin_base_url):
page.goto(f"{admin_base_url}/admin")
expect(page.locator("#messageArea")).to_have_text("")
for title in ("Providers", "Model Config", "Messaging", "Integrations"):
page.get_by_role("button", name=title, exact=True).click()
assert_autofill_opt_out(page)
page.get_by_role("button", name="Providers", exact=True).click()
open_provider(page, "nvidia_nim")
assert_autofill_opt_out(page)
key = api_key_input(page, "NVIDIA_NIM_API_KEY")
expect(key).to_have_value("")
expect(key).to_have_attribute("type", "password")
expect(key).to_have_attribute("autocapitalize", "none")
expect(key).to_have_attribute("spellcheck", "false")
expect(key).to_have_attribute("autocorrect", "off")
expect(page.locator('.field input[type="password"]')).to_have_count(1)
key.fill("manually-entered-api-key")
expect(key).to_have_value("manually-entered-api-key")
expect(page.locator("#saveProvider")).to_be_enabled()
def test_selected_admin_tab_survives_refresh_and_browser_navigation(
page, admin_base_url
):
page.goto(f"{admin_base_url}/admin")
for title, path in (
("Model Config", "/admin/model_config"),
("Messaging", "/admin/messaging"),
("Integrations", "/admin/integrations"),
("Providers", "/admin"),
):
page.get_by_role("button", name=title, exact=True).click()
expect(page).to_have_url(f"{admin_base_url}{path}")
page.reload()
expect(page.locator("#pageTitle")).to_have_text(title)
expect(page.get_by_role("button", name=title, exact=True)).to_have_attribute(
"aria-current", "page"
)
page.go_back()
expect(page.locator("#pageTitle")).to_have_text("Integrations")
page.go_forward()
expect(page.locator("#pageTitle")).to_have_text("Providers")
def test_admin_removes_chat_drafts_and_preserves_other_storage(page, admin_base_url):
page.add_init_script("""(() => {
for (let index = 0; index < 16; index++) {
sessionStorage.setItem(`fcc.chat.draft.${index}`, `old draft ${index}`);
}
for (let index = 0; index < 16; index++) {
sessionStorage.setItem(`fcc.code.${index}`, `keep code draft ${index}`);
}
sessionStorage.setItem('fcc.chat.draftWithoutDot', 'keep unrelated key');
sessionStorage.setItem('other-admin-state', 'keep admin state');
})();""")
page.goto(f"{admin_base_url}/admin")
expect(page.locator('[data-provider="nvidia_nim"]')).to_be_visible()
assert page.evaluate("Object.fromEntries(Object.entries(sessionStorage))") == {
**{f"fcc.code.{index}": f"keep code draft {index}" for index in range(16)},
"fcc.chat.draftWithoutDot": "keep unrelated key",
"other-admin-state": "keep admin state",
}
expect(page.locator('.nav-link[data-view="providers"]')).to_have_attribute(
"aria-current", "page"
)
expect(page.get_by_role("button", name="Chat Sessions", exact=True)).to_have_count(
0
)
page.get_by_role("button", name="Code sessions", exact=True).click()
expect(page).to_have_url(f"{admin_base_url}/admin/code")
expect(
page.get_by_role("button", name="New code session", exact=True)
).to_be_enabled()
def test_admin_storage_denial_keeps_admin_usable(page, admin_base_url):
errors = []
warnings = []
page.on("pageerror", lambda error: errors.append(str(error)))
page.on(
"console",
lambda message: (
warnings.append(message.text) if message.type == "warning" else None
),
)
page.add_init_script("""Object.defineProperty(window, 'sessionStorage', {
get() { throw new DOMException('Storage is denied', 'SecurityError'); }
});""")
page.goto(f"{admin_base_url}/admin")
expect(page.locator('[data-provider="nvidia_nim"]')).to_be_visible()
page.get_by_role("button", name="Code sessions", exact=True).click()
expect(
page.get_by_role("button", name="New code session", exact=True)
).to_be_enabled()
assert errors == []
assert any("Chat draft cleanup deferred" in message for message in warnings)
def test_admin_loads_current_release_assets_before_rendering_dynamic_content(
page: Page,
admin_base_url: str,
) -> None:
requested_paths: list[str] = []
page_errors: list[str] = []
def record_request(request: Request) -> None:
requested_paths.append(urlsplit(request.url).path)
def record_page_error(error: Error) -> None:
page_errors.append(str(error))
page.on("request", record_request)
page.on("pageerror", record_page_error)
page.goto(f"{admin_base_url}/admin")
expect(page.locator('[data-provider="nvidia_nim"]')).to_be_visible()
expect(page.locator(".brand p")).to_have_text(
f"Server Control · v{package_version()}"
)
logo_link = page.get_by_role("link", name="Open Free Claude Code on GitHub")
expect(logo_link).to_be_visible()
expect(logo_link).to_have_attribute(
"href", "https://github.com/Alishahryar1/free-claude-code"
)
expect(logo_link).to_have_attribute("target", "_blank")
versioned_root = f"/admin/assets/{package_version()}"
assert f"{versioned_root}/app-icon.svg" in requested_paths
assert f"{versioned_root}/admin.css" in requested_paths
assert f"{versioned_root}/code_sessions.css" in requested_paths
assert f"{versioned_root}/model_combobox.js" in requested_paths
assert f"{versioned_root}/form_controls.js" in requested_paths
assert f"{versioned_root}/code_sessions.js" in requested_paths
assert f"{versioned_root}/admin.js" in requested_paths
assert "/admin/assets/admin.css" not in requested_paths
assert "/admin/assets/code_sessions.css" not in requested_paths
assert "/admin/assets/model_combobox.js" not in requested_paths
assert "/admin/assets/code_sessions.js" not in requested_paths
assert "/admin/assets/admin.js" not in requested_paths
assert not any("/chat_sessions." in path for path in requested_paths)
assert page_errors == []