Jetpack Compose Rules - Static checks for Ktlint and Detekt
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.
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!
We love sharing and learning from others; contributing new rules or fixes is welcome. See the Contributing instructions for more information.
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
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.