fix readme and ci/cd containers

Author: e-gleba

CMakeLists.txt

@@ -29,7 +29,7 @@ find_package(package CONFIG REQUIRED)
 
 # Tooling (optional but guarded)
 option(ENABLE_DEV_TOOLS "Enable dev tools like clang-format, clang-tidy, etc."
-       ON)
+       OFF)
 
 if(ENABLE_DEV_TOOLS)
     find_package(clang_format CONFIG QUIET)

docker/fedora.Dockerfile

@@ -3,7 +3,7 @@ FROM fedora:latest
 WORKDIR /app
 
 # Install essential C++ development tools, documentation, and workflow tools
-RUN dnf -y upgrade && \
+RUN dnf -y upgrade --refresh && \
     dnf -y install \
     clang \
     clang-tools-extra \
@@ -13,14 +13,15 @@ RUN dnf -y upgrade && \
     ninja-build \
     make \
     gcc-c++ \
-    cups-devel && \
-    dnf clean all
+    && dnf clean all
 
 COPY . /app
 
-# Optionally, set an entrypoint for workflow automation
-# Example: Run a specific CMake workflow preset
+# Validate CMake preset early (fail fast if misconfigured)
+RUN cmake --preset=gcc-full --check-presets
+
+# Default entrypoint: run the full build/test workflow
 ENTRYPOINT ["cmake", "--workflow", "--preset=gcc-full"]
 
-# Or, keep an interactive shell for development
+# Fallback: interactive shell if needed (e.g., docker run -it --entrypoint /bin/bash ...)
 # CMD ["/bin/bash"]

docker/manjaro.Dockerfile

@@ -6,19 +6,22 @@ WORKDIR /app
 
 # Install essential C++ development tools, documentation, and workflow tools
 RUN pacman -Syu --noconfirm && \
-    pacman -S --noconfirm \
+    pacman -S --needed --noconfirm \
     base-devel \
     clang \
     clang-doc \
     doxygen \
     cmake \
     git \
-    ninja
+    ninja \
+    && pacman -Scc --noconfirm
 
 # Copy the source code into the container
 COPY . /app
 
-# Optionally, set an entrypoint for workflow automation
+# Validate CMake preset early to fail fast on configuration errors
+RUN cmake --preset=gcc-full --check-presets
+
 # Example: Run a specific CMake workflow preset
 ENTRYPOINT ["cmake", "--workflow", "--preset=gcc-full"]
 

readme.md

@@ -22,10 +22,10 @@
 - **🛡️ Code Quality Tools**: Integrated targets for maintaining high standards
 - **📦 CPM Package Management**: Simplified dependency handling
 - **📄 Doxygen Configuration**: Seamless documentation generation
-- **🧪 CTest Integration**: Straightforward testing setup
+- **🧪 CTest Integration**: Straightforward testing setup (doctest + androidTest)
 - **🐳 Docker Support**: Pre-configured containerization
 - **💻 IDE Compatibility**: Works with QtCreator, CLion, Visual Studio, KDevelop
-- **🌐 Cross-Platform**: Linux, Windows, macOS support
+- **🌐 Cross-Platform**: Linux, Windows, Android, macOS support
 - **🏗️ CMake-Driven**: Streamlined CI/CD configuration
 
 ## Advanced Feature Matrix
@@ -34,26 +34,22 @@ Contemporary C++ development requires sophisticated tooling integration that add
 
 ### Core Development Features
 
-| Component             | Technology                       | Configuration                | Performance Impact         |
-| --------------------- | -------------------------------- | ---------------------------- | -------------------------- |
-| **Build System**      | CMake 3.28+                      | Multi-preset configuration   | Zero runtime overhead      |
-| **Compiler Support**  | GCC 13+, Clang 16+, MSVC 19.35+  | Standards-compliant C++23/26 | Optimal code generation    |
-| **Memory Management** | Custom allocators, RAII patterns | Stack-preferring design      | Sub-microsecond allocation |
-| **Concurrency**       | std::execution, coroutines       | Lock-free data structures    | Minimal contention         |
-| **Error Handling**    | std::expected, error codes       | Zero-cost exception safety   | Predictable performance    |
+| Component             | Technology                       | Configuration                |
+| --------------------- | -------------------------------- | ---------------------------- |
+| **Build System**      | CMake 3.30+                      | Multi-preset configuration   |
+| **Compiler Support**  | GCC 13+, Clang 16+, MSVC 19.35+  | Standards-compliant C++23/26 |
 
 ### Quality Assurance Pipeline
 
-| Tool Category             | Implementation                    | Integration             | Quality Metrics                  |
-| ------------------------- | --------------------------------- | ----------------------- | -------------------------------- |
-| **Static Analysis**       | Clang-Static-Analyzer, PVS-Studio | Pre-commit hooks        | Zero false positives             |
-| **Dynamic Analysis**      | AddressSanitizer, MemorySanitizer | CI/CD integration       | 100% memory safety               |
-| **Performance Profiling** | Perf, Intel VTune, Tracy          | Continuous benchmarking | Performance regression detection |
-| **Documentation**         | Doxygen, Sphinx                   | Automated generation    | API coverage tracking            |
+| Tool Category             | Implementation                    | Integration             | 
+| ------------------------- | --------------------------------- | ----------------------- | 
+| **Static Analysis**       | Clang-Static-Analyzer, PVS-Studio | Pre-commit hooks        | 
+| **Dynamic Analysis**      | AddressSanitizer, MemorySanitizer | CI/CD integration       |
+| **Documentation**         | Doxygen                           | Automated generation    |
 
 ## 🚧 Prerequisites
 
-- `cmake 3.25.0+`
+- `cmake 3.30.0+`
 - `C++ compiler with C++23 support`
 - `ninja`
 - `(optional) cmake/cfg/*.cmake tools`
@@ -132,7 +128,21 @@ python -m http.server 8080
 
 ## 🚧 Roadmap
 
-- [ ] Add Android build support
+- [ ] develop
+
+## 📖 Learning Resources
+
+### Essential Reading
+- **[C++ Weekly](https://www.youtube.com/@cppweekly)** by Jason Turner — Weekly doses of modern C++
+- **[Performance-Aware Programming](https://www.computerenhance.com/)** by Casey Muratori — Hardware-conscious development
+- **[C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/)** by Stroustrup & Sutter — Industry best practices
+- **[Effective Modern C++](https://www.oreilly.com/library/view/effective-modern-c/9781491908419/)** by Scott Meyers — Essential patterns
+
+### Technical References
+- **[cppreference.com](https://en.cppreference.com/)** — Comprehensive language reference
+- **[C++23 Features](https://en.cppreference.com/w/cpp/23)** — Latest standard capabilities
+- **[Compiler Explorer](https://godbolt.org/)** — Live assembly output analysis
+- **[Quick Bench](https://quick-bench.com/)** — Online micro-benchmarking
 
 ## 🤝 Contributing
 
@@ -145,3 +155,9 @@ Contributions are welcome! Fork the repository and submit a pull request.
 ## 🙏 Acknowledgments
 
 Thanks to CMake, CTest, and the open-source community.
+
+--- 
+
+> *"C++ is a language for people who want both elegance and efficiency."* — **Bjarne Stroustrup**
+
+Built with 💙 by developers who believe that **performance-aware programming** is not premature optimization — it's responsible engineering.

src/CMakeLists.txt

@@ -13,6 +13,8 @@ install(TARGETS cli_app RUNTIME DESTINATION bin COMPONENT runtime)
 
 add_library(sdl_app SHARED sdl_main.cpp)
 target_link_libraries(sdl_app PRIVATE SDL3::SDL3-shared warnings)
+set_target_properties(sdl_app PROPERTIES CXX_STANDARD 23 CXX_STANDARD_REQUIRED
+                                                         YES CXX_EXTENSIONS NO)
 
 install(
     TARGETS sdl_app