maturita.c/CLAUDE.md

CLAUDE.md

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

Development Commands

• Build: Compile the GTK application using the Makefile:

  make
  

  Or manually with gcc:

  gcc -o sprechen sprechen.c `pkg-config --cflags --libs gtk4`
  

• Run: Execute the built binary:

  make run
  

  or

  ./sprechen
  

• Clean: Remove compiled binaries:

  make clean
  

  or

  rm -f sprechen
  

• Format: If using clang-format, run:

  clang-format -i *.c *.h
  

• Lint: Use clang-tidy or cppcheck for static analysis:

  clang-tidy sprechen.c -- `pkg-config --cflags gtk4`
  

  or

  cppcheck --enable=all sprechen.c
  

• Test: Currently no test framework is integrated. To add unit tests, consider using a lightweight framework like check or cmocka. Tests can be compiled and run similarly.

Project Structure

• Root: Contains the CLAUDE.md, README.md, .gitignore, LICENSE, Makefile, and source files.
• Source: The main application resides in a single C file (sprechen.c) that uses GTK 4 for the graphical interface.
• Build Artifacts: Compiled binaries are placed in the project root by default; consider using a build/ directory for out-of-source builds.
• Dependencies: Requires GTK 4 development libraries. On macOS, install via Homebrew: brew install gtk4. On Linux, use your package manager (e.g., sudo apt install libgtk-4-dev).

Architecture Overview

The application is a simple GUI program written in C using GTK 4. It features:

• A main window with a title "Sprechen.c".
• A vertical box layout containing a centered label with welcome text.
• Custom CSS styling for a gradient background and styled label box.
• The text size scales dynamically with the window width to ensure readability on different screen sizes.
• The GTK application lifecycle is managed via GtkApplication, with activation callback setting up the UI.

Future extensions may include:

• Additional widgets for language lessons (buttons, text entry, progress bars).
• Separation of UI code into multiple files (e.g., ui.c, ui.h).
• Lesson data structures and loading from external files (JSON or plain text).
• Internationalization support using gettext.

Notes

• Ensure GTK 4 is installed and accessible via pkg-config.
• The code adheres to GTK 4 conventions and uses CSS for styling.
• When modifying the UI, consider keeping the CSS in a separate file for maintainability, though currently it is embedded for simplicity.