Skip to content

mrmans0n/compose-rules

 
 

Repository files navigation

Jetpack Compose Rules - Static checks for Ktlint and Detekt

Build & test Maven Central

Note This repository is a fork of the Twitter Jetpack Compose Rules by its original maintainer. As none of the admins/maintainers continue working at the company, its development will continue here from now on. If you come from that project, check out the migration guide.

Overview

It can be challenging for big teams to start adopting Compose, particularly because not everyone will start at same time or with the same patterns. We tried to ease the pain by creating a set of Compose static checks.

Compose has lots of superpowers but also has a bunch of footguns to be aware of as seen in this Twitter Thread.

This is where our static checks come in. We want to detect as many potential issues as we can, as quickly as we can. In this case we want an error to show prior to engineers having to review code. Similar to other static check libraries we hope this leads to a "don't shoot the messengers" philosphy which will foster healthy Compose adoption.

Check out the project website for more information: https://mrmans0n.github.io/compose-rules

Static checks for Compose bundled in this repo

You can find the comprehensive list of rules in the rules documentation. It contains both the what and why for each rule, we encourage you to read it prior to adopting our rules.

There are 2 ways you can add these static checks to your build - using Ktlint or using Detekt.

Using with Ktlint

You can refer to the Using with Ktlint documentation.

Using with Detekt

You can refer to the Using with Detekt documentation.

Using with Lint

There is a project using these rules and running them via Android's Lint, that is maintained by Slack. Check it out here!

Contributing

We love sharing and learning from others; contributing new rules or fixes is welcome. See the Contributing instructions for more information.

License

    Copyright 2022 Twitter, Inc.
    Copyright 2024 Nacho Lopez.

    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.
    You may obtain a copy of the License at

      http://www.apache.org/licenses/LICENSE-2.0

    Unless required by applicable law or agreed to in writing, software
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
    limitations under the License.

About

Static checks to aid with a healthy adoption of Compose. Maintained fork of the Twitter Compose rules.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Kotlin 100.0%