docs/index.md
author Da Risk <da_risk@geekorum.com>
Tue, 24 Jun 2025 15:18:18 -0400
changeset 103 c78c87a77df2
parent 91 b3b57696b660
permissions -rw-r--r--
build: update to kotlin 2.2.20
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
91
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
     1
[![Release Version](https://img.shields.io/maven-central/v/com.geekorum.aboutoss/core?label=release)](https://search.maven.org/#search%7Cga%7C1%7Caboutoss)
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
     2
[![License](https://img.shields.io/github/license/fbarthelery/AboutOss)](https://github.com/fbarthelery/AboutOss/blob/main/LICENSE)
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
     3
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
     4
AboutOss
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
     5
==========
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
     6
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
     7
AboutOss is a Kotlin Multiplatform utility library to retrieve and display opensource licenses in your applications.
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
     8
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
     9
```kotlin title="build.gradle.kts"
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    10
implementation("com.geekorum.aboutoss:ui-material3:<latest-version>")
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    11
```
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    12
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    13
License sources
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    14
---------------
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    15
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    16
The library can work with license information files generated by:
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    17
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    18
- [OSS Licenses Gradle Plugin](https://github.com/google/play-services-plugins/tree/main/oss-licenses-plugin)
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    19
- [licensee](https://github.com/cashapp/licensee)
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    20
- [LicensePlist](https://github.com/mono0926/LicensePlist)
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    21
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    22
See [license sources](license-sources.md) for more information
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    23
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    24
User interface
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    25
--------------
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    26
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    27
The user interface to display license information is written in [Compose Multiplatform](https://github.com/JetBrains/compose-multiplatform).
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    28
There is out of the box composables for Material and Material3 and you can easily write your own UI.
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    29
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    30
Check the sample [here](https://github.com/fbarthelery/AboutOss/tree/main/sample)
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    31
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    32
Build instructions
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    33
==================
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    34
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    35
Just use Gradle to build
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    36
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    37
    ./gradlew build
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    38
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    39
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    40
License
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    41
=======
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    42
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    43
AboutOss is an open source library and is licensed under the GNU General Public License 3 and any later version.
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    44
This means that you can get AboutOss's code and modify it to suit your needs, as long as you publish the changes
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    45
you make for everyone to benefit from as well.
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    46
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    47
AboutOss is built and maintained by community volunteers.