https://github.com/nativeapptemplate/nativeapptemplate-free-android

Modern, comprehensive, and production-ready native Android app with user authentication.
https://github.com/nativeapptemplate/nativeapptemplate-free-android

android authentication jetpack-compose kotlin rest-api saas saas-boilerplate

Last synced: 18 days ago
JSON representation

Modern, comprehensive, and production-ready native Android app with user authentication.

• Host: GitHub
• URL: https://github.com/nativeapptemplate/nativeapptemplate-free-android
• Owner: nativeapptemplate
• License: mit
• Created: 2024-12-07T03:29:27.000Z (20 days ago)
• Default Branch: main
• Last Pushed: 2024-12-08T03:45:17.000Z (19 days ago)
• Last Synced: 2024-12-08T04:23:15.464Z (19 days ago)
• Topics: android, authentication, jetpack-compose, kotlin, rest-api, saas, saas-boilerplate
• Language: Kotlin
• Homepage: https://nativeapptemplate.com
• Size: 315 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Security: SECURITY.md

Awesome Lists containing this project

README

        
# NativeAppTemplate-Free-Android

NativeAppTemplate-Free-Android is a modern, comprehensive, and production-ready native iOS app with user authentication.  

This Android app is a free version of  [NativeAppTemplate-Android (Solo)](https://nativeapptemplate.com/products/android-solo) and [NativeAppTemplate-Android (Team)](https://nativeapptemplate.com/products/android-team).

## Overview

NativeAppTemplate-Free-Android is configured to connect to `api.nativeapptemplate.com`.  

You can purchase the source code for the backend server APIs that power `api.nativeapptemplate.com`:

- [NativeAppTemplate-API (Solo)](https://nativeapptemplate.com/products/api-solo)  

- [NativeAppTemplate-API (Team)](https://nativeapptemplate.com/products/api-team)

### Features

NativeAppTemplate-Free-Android uses modern Android development tools and practices, including:

- **100% Kotlin**

- **100% Jetpack Compose**

- **Hilt** (Dependency Injection)

- **Retrofit2** (Networking)

- **[Proto DataStore](https://developer.android.com/topic/libraries/architecture/datastore)**  

- **[Android Modern App Architecture](https://developer.android.com/topic/architecture#modern-app-architecture)**  

- Inspired by [nowinandroid](https://github.com/android/nowinandroid) and [emitron-Android](https://github.com/razeware/emitron-Android)

#### Included Features

- Onboarding

- Sign Up / Sign In / Sign Out

- Email Confirmation

- Forgot Password

- Input Validation

- CRUD Operations for Shops (Create/Read/Update/Delete)

- And more!

#### Not Included in the Free Version

The full versions ([NativeAppTemplate-Android (Solo)](https://nativeapptemplate.com/products/android-solo) and [NativeAppTemplate-Android (Team)](https://nativeapptemplate.com/products/android-team)) include additional advanced features:

- URL Path-Based Multitenancy (e.g., prepends `/:account_id/` to URLs)

- User Invitation to Organizations

- Role-Based Permissions and Access Control

## Getting Started

To get started, clone this repository:

```bash

git clone https://github.com/nativeapptemplate/NativeAppTemplate-Free-Android.git

```

## Requirements

To run this app successfully, ensure you have:

- An Android device or emulator with API level 26 or higher.

## Running with the NativeAppTemplate-API on localhost

To connect to a local API server, update the following configuration in the build.gradle.kts (Module: app):

```kotlin

buildConfigField("String", "DOMAIN","\"192.168.1.21\"")

buildConfigField("String", "PORT","\"3000\"")

buildConfigField("String", "SCHEME","\"http\"")

```

## Contributing

If you have an improvement you'd like to share, create a fork of the repository and send us a pull request.