Skip to content

Latest commit

 

History

History
 
 

Jetsurvey

README.md

Jetsurvey sample

Jetsurvey is a sample survey app, built with Jetpack Compose. The goal of the sample is to showcase text input, validation and state capabilities of Compose.

To try out these sample apps, you need to use the latest Canary version of Android Studio 4.2. You can clone this repository or import the project from Android Studio following the steps here.

Screenshots

Features

This sample contains several screens: a welcome screen, where the user can enter their email, sign in and sign up screens and a survey screen. The app has light and dark themes.

App scaffolding

Package com.example.compose.jetsurvey

MainActivity is the application's entry point. Each screen is implemented inside a Fragment and MainActivity is the host Activity for all of the Fragments. The navigation between them uses the Navigation library. The screens and the navigation are defined in Navigation.kt

Sign in/sign up

Package com.example.compose.jetsurvey.signinsignup

This package contains 3 screens:

  • Welcome
  • Sign in
  • Sign up

To get to the sign up screen, enter an email that contains "signup". These screens show how to create different custom composable functions, reused them across multiple screens and handle UI state.

See how to:

  • Use TextFields
  • Implement TextField validation across one TextField (e.g. email validation) and across multiple TextFields (e.g. password confirmation)
  • Use a Snackbar
  • Use different types of Buttons: TextButton, OutlinedButton and Button

Complete a survey

Package com.example.compose.jetsurvey.survey

This screen allows the user to fill out a survey, showing how to handle complex state. UI state is kept and restored on recompositions triggered by different reasons like a configuration change or a new question being displayed on the screen.

See how to:

  • Use RadioButtons - for single item selection
  • Use Checkboxes - for multi-item selection
  • Use Slider - for picking a value from a range
  • Use Scaffold - for screens with top bar, bottom bar and body
  • Display a DialogFragment when requested from compose

Data

The data in the sample is static, held in the *Repository classes.

Setup

The main README has instructions on how to setup this sample, and many others.

License

Copyright 2020 The Android Open Source Project

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

    https://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.