Repository files navigation

flex is a flexible box layout system following theCSS flexbox module specifications. The goal is to offer a fully compliant implementation with a small and maintainable code base under a permissive license.

flex exposes a plain C API with the same parameters that you would use in CSS to customize the layout of a flexible view hierarchy. The API is designed to be easily interoperable with foreign runtimes (ex. C#) and meant to be used by widget toolkits as the foundation of a view layout API.

flex supports both single and multiple (wrap) lines layouts.

If you program in C# you can go straight to thebindings/csharp directory.

If you program in a C-compatible environment you can simply copy theflex.c andflex.h files to your project. The code was written to be cross-platform and does not require dependencies.

On a Mac you can also generate static and dynamic libraries for iOS, Android and macOS usingmake:

$ make macos$ make ios$ make android$ make             # builds everything

Make sure to have theANDROID_NDK environment variable set to the path where the Android NDK is located in your system. You can also tweak build variables by editing theMakefile file.

On a Windows machine you can generate dynamic libraires (DLL) for x86, x64, ARM and ARM64 by opening the Visual Studio project file or runningmsbuild from the command line.

Under thedemo directory you will find an Xcode project that will build a Mac demo app. The app exposes the entire set of flexbox parameters that are implemented and lets you create views (including nested ones), similar to how you would build a more realistic user interface in practice.

There is a test suite in thetests directory. See thetests/README.md file for more details on how to build, run and contribute to the test suite.

flex is distributed under the terms of the MIT license. See theLICENSE.txt file for more information.