1# Jetpack Compose
2## Intro
3Jetpack Compose is a suite of libraries within the AndroidX ecosystem. For more information, see our [project page](https://developer.android.com/jetpackcompose)
4
5## Syntax
6Jetpack Compose uses composable functions instead of XML layouts to define UI components. You can
7see this in action in the demos, like `androidx.compose.material.demos.ButtonDemo.kt`. More
8information can be found in the [compiler README](https://android.googlesource.com/platform/frameworks/support/+/androidx-main/compose/compiler/README.md).
9
10## Compiler
11Composable functions are built using a custom Kotlin compiler plugin. More information about the
12compiler plugin is available in [this README](https://android.googlesource.com/platform/frameworks/support/+/androidx-main/compose/compiler/README.md).
13
14## Getting started
15To try out Jetpack Compose you need to set up the toolchain for AndroidX development. Follow the process [here](https://android.googlesource.com/platform/frameworks/support/+/androidx-main/README.md) to check out the code.
16
17To start the required version of Android Studio, you need to run the `ANDROIDX_PROJECTS=COMPOSE ./gradlew studio`
18
19    cd path/to/checkout/frameworks/support/
20    ANDROIDX_PROJECTS=COMPOSE ./gradlew studio
21
22Also if you would like to build from the command line, all gradle commands need to be run from the
23`frameworks/support` folder.  E.g. to build the demo app, run:
24
25    cd path/to/checkout/frameworks/support/
26    ./gradlew :compose:integration-tests:demos:installDebug
27
28## Structure
29Library code for Jetpack Compose lives under the `frameworks/support/compose` directory. Additionally, sample code can be found within each module in the `integration-tests` subdirectories. Run the `demos` app to see examples of components and behavior.
30
31## Guidance and documentation
32
33[Get started with Jetpack Compose](https://goo.gle/compose-docs)
34
35[Samples](https://goo.gle/compose-samples)
36
37[Pathway course](https://goo.gle/compose-pathway)
38
39## Feedback
40To provide feedback or report bugs, please refer to the main [AndroidX contribution guide](https://android.googlesource.com/platform/frameworks/support/+/androidx-main/README.md) and report your bugs [here](https://issuetracker.google.com/issues/new?component=612128)
41
42[Release notes](https://developer.android.com/jetpack/androidx/releases/compose)
43
44[Browse source](https://cs.android.com/androidx/platform/frameworks/support/+/androidx-main:compose/)
45
46[Existing open bugs](https://issuetracker.google.com/issues?q=componentid:612128%20status:open)
47
48[File a new bug](https://issuetracker.google.com/issues/new?component=612128)
49
50[Slack](https://goo.gle/compose-slack)
51