# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Project Overview

This is a Docker image project for Robot Framework test automation. It packages Robot Framework with commonly used testing libraries and browser drivers (Firefox, Chrome) into a containerized environment for running automated tests.

## Build Commands

The project uses `build-tools` (not Docker buildx) for building:
```bash
build    # Build the Docker image
push     # Push the image to registry
```

## Project Structure

- `Dockerfile` - Main container definition based on Python slim, installs browsers and RF libraries
- `requirements.txt` - Python dependencies (Robot Framework + libraries)
- `.version` - JSON file containing the current version
- `cliff.toml` - git-cliff configuration for changelog generation
- `.gitea/workflows/ci.yaml` - CI pipeline (builds on push/PR to main)

## Key Libraries Included

- robotframework-browser (Playwright-based)
- robotframework-seleniumlibrary
- robotframework-appiumlibrary
- robotframework-databaselibrary (with PostgreSQL/MySQL drivers)
- robotframework-requests
- robotframework-httplibrary

## Versioning

The project uses semantic versioning. Version is stored in `.version` as JSON. Changelog is auto-generated using git-cliff with conventional commits.

## CI/CD

Uses Gitea Actions. The pipeline runs `build` and `push` on main branch and pull requests.