auto formatting of the code

.clang-format

@@ -0,0 +1,2 @@
+BasedOnStyle: LLVM
+ReflowComments: false

.editorconfig

@@ -1,3 +1,7 @@
 [*]
 end_of_line = lf
 
+[*.{c,cpp,h,hpp}]
+indent_style = space
+indent_size = 4
+

.github/workflows/build-and-test.yml

@@ -34,6 +34,12 @@ jobs:
         run: |
           sudo apt install libgtest-dev cmake
 
+      - name: Format check
+        if: matrix.runner == 'ubuntu-latest'
+        run: |
+          sudo apt install clang-format
+          make format-check
+
       - name: Test with CMake (-DSIMPLEINI_USE_SYSTEM_GTEST=OFF)
         run: |
           cmake -S . -B build -DSIMPLEINI_USE_SYSTEM_GTEST=OFF

Makefile

@@ -0,0 +1,51 @@
+# Convenience targets around CMake. The build system remains CMake; this Makefile
+# only configures build/ and invokes cmake/ctest/clang-format from the tree root.
+
+BUILD_DIR := build
+CMAKE := cmake
+CLANG_FORMAT ?= clang-format
+FORMAT_FILES := SimpleIni.h $(wildcard tests/*.cpp)
+
+CMAKE_FLAGS := -DCMAKE_BUILD_TYPE=Debug
+
+JOBS := $(shell nproc 2>/dev/null || sysctl -n hw.ncpu 2>/dev/null || echo 4)
+
+.PHONY: all help configure build test format format-check check clean
+
+all: build
+
+help:
+	@echo "SimpleIni developer targets:"
+	@echo "  make configure     Configure the CMake build in $(BUILD_DIR)/"
+	@echo "  make build         Build tests (warnings are errors)"
+	@echo "  make test          Run tests via ctest"
+	@echo "  make format        Apply clang-format to sources"
+	@echo "  make format-check  Verify formatting (no writes)"
+	@echo "  make check         format-check, build, and test"
+	@echo "  make clean         Remove $(BUILD_DIR)/"
+
+configure: $(BUILD_DIR)/CMakeCache.txt
+
+$(BUILD_DIR)/CMakeCache.txt:
+	$(CMAKE) -S . -B $(BUILD_DIR) $(CMAKE_FLAGS)
+
+build: configure
+	$(CMAKE) --build $(BUILD_DIR) -j $(JOBS)
+
+test: build
+	$(CMAKE) -E chdir $(BUILD_DIR) ctest --output-on-failure
+
+format:
+	@command -v $(CLANG_FORMAT) >/dev/null 2>&1 \
+		|| { echo "error: $(CLANG_FORMAT) not found; install clang-format" >&2; exit 1; }
+	$(CLANG_FORMAT) -i $(FORMAT_FILES)
+
+format-check:
+	@command -v $(CLANG_FORMAT) >/dev/null 2>&1 \
+		|| { echo "error: $(CLANG_FORMAT) not found; install clang-format" >&2; exit 1; }
+	$(CLANG_FORMAT) --dry-run --Werror $(FORMAT_FILES)
+
+check: format-check test
+
+clean:
+	rm -rf $(BUILD_DIR)

README.md

@@ -47,7 +47,22 @@ That's it! The library is ready to use.
 
 # Build and Test
 
-While the library itself doesn't require building, you can build and run the test suite using CMake.
+While the library itself doesn't require building, you can build and run the test suite using CMake. A top-level `Makefile` wraps the usual CMake workflow for local development:
+
+```bash
+make help          # list targets
+make check         # format-check, build, and test
+make format        # apply clang-format
+make format-check  # verify formatting
+make test          # run ctest
+make clean         # remove build/
+```
+
+Requires `cmake`, a C++17 compiler, and `clang-format` for format targets. Test builds use `-Werror`. CMake remains the build system.
+
+CI (`.github/workflows/build-and-test.yml`) runs `make format-check` on Linux only; tests run on Linux (x64 and arm64), Windows, and macOS.
+
+Direct CMake usage:
 
 ```bash
 # Configure the project