Giter Site home page Giter Site logo

vaibhav2002 / docubox-androidapp Goto Github PK

View Code? Open in Web Editor NEW
43.0 1.0 8.0 26.88 MB

DocuBox is an android app πŸ“±in which you can securely upload your files on the cloud– from family pictures and audio recordings to spreadsheets, presentations and other confidential documents.

License: MIT License

Kotlin 100.00%
android clean-code coroutines-flow daggerhilt datastore kotlin linode mvvm retrofit2 solid-principles

docubox-androidapp's Introduction

DocuBox

DocuBox is a cloud based file storing app where you can securely store and access your documents from anywhere around the world!

This project is developed by Team 404 for Hashnode x Linode hackathon. This team comprises of Ishant and Vaibhav.

Blog ✍

To know more about how I build this project, read my article on https://ishantchauhan.hashnode.dev/docubox-securely-store-access-and-share-your-files-on-cloud

Application Install

You can Install and test latest DocuBox app from below πŸ‘‡

DocuBox

How to use this app

To know how to use this app read this or watch this video

Setup

  • Clone the repository on your machine.
  • Clone the backend code and set it up by following its README.
  • After setting up the backend, do the following:

Open Secrets.kt in util package and add your backend Base URL

//Add your base url here
const val BASE_URL = "http://[your server url]/api/"

About

It uses a nodejs backend which is deployed on an ubuntu server running on Linode.

  • Fully functionable.
  • Clean and Simple Material UI.
  • Best and Clean Code Quality following Modern Android Development, SOLID Principles and much more.

App Features

  • User Authentication - Supports email based authentication
  • Saving Files - You can upload your files to DocuBox's cloud storage and access it anywhere.
  • File Encryption - Files stored on DocuBox is secure and encrypted, so your data is securely stored.
  • Sharing File Access - You can share view access of your files to other users.
  • File Management - You can create multiple folders to organize your storage just as you want it.
  • File Download - You can even download your files and save them locally for offline access.
  • Enhanced File Search - Super fast file searching which can search files instantly.

Insights into the app πŸ”Ž

πŸ“Έ Screenshots

Technical details

  • DocuBox uses custom NodeJS Server running on Linode as its backend.
  • DocuBox uses Retrofit to make all REST API calls to the NodeJS backend.
  • DocuBox is made using Kotlin and following Modern Android Development practices.
  • DocuBox uses Kotlin Coroutines and Flow to handle all asynchronous tasks.
  • DocuBox uses all Jetpack libraries and follows MVVM architecture. It also has a G.O.A.T rating in Android's M.A.D scorecard.
  • DocuBox's code follows all the best practices and software development principles like SOLID which make it a very good learning resource for beginners as well as for people looking to improve thier software design skills.
  • DocuBox's code is properly linted using Ktlint.

summary.jpg

Built With πŸ› 

  • Kotlin - First class and official programming language for Android development.
  • Coroutines - For asynchronous and more..
  • Flow - A cold asynchronous data stream that sequentially emits values and completes normally or with an exception.
  • StateFlow - StateFlow is a state-holder observable flow that emits the current and new state updates to its collectors.
  • SharedFlow - A SharedFlow is a highly-configurable generalization of StateFlow.
  • Android Architecture Components - Collection of libraries that help you design robust, testable, and maintainable apps.
    • ViewModel - Stores UI-related data that isn't destroyed on UI changes.
    • ViewBinding - Generates a binding class for each XML layout file present in that module and allows you to more easily write code that interacts with views.
    • DataBinding - Binds data directly into XML layouts
    • DataStore - Jetpack DataStore is a data storage solution that allows you to store key-value pairs or typed objects with protocol buffers.
  • Dependency Injection -
    • Hilt-Dagger - Standard library to incorporate Dagger dependency injection into an Android application.
    • Hilt-ViewModel - DI for injecting ViewModel.
  • GSON - A modern JSON library for Kotlin and Java.
  • Timber - A simple logging library for android.
  • Retrofit - A type-safe HTTP client for Android and Java.
  • GSON Converter - A Converter which uses Moshi for serialization to and from JSON.
  • Coil - An image loading library for Android backed by Kotlin Coroutines.
  • Material Components for Android - Modular and customizable Material Design UI components for Android.

Package Structure

com.docubox             # Root Package
.
β”œβ”€β”€ data                # For data handling.
|   β”œβ”€β”€ local           # Local Datasource and classes
|   β”œβ”€β”€ remote          # Remote datasources and API Service
β”‚   β”œβ”€β”€ model           # Model data classes and mapper classes, both remote and local entities
β”‚   └── repo            # Single source of data.
|
β”œβ”€β”€ service             # Foreground Service to upload File to server
|
β”œβ”€β”€ di                  # Dependency Injection             
β”‚   └── module          # DI Modules
|
β”œβ”€β”€ ui                  # UI/View layer
|   β”œβ”€β”€ adapters        # Adapter, ViewHolder and DiffUtil
|   └── screens         # All App Screens 
|
└── utils               # Utility Classes / Kotlin extensions

Architecture

This app uses MVVM (Model View View-Model) architecture.


If you like my projects and want to support me to build more cool open source projects

Attribution

The project uses backend which is deployed on Linode for the Hashnode X Linode Hackathon.


Contact

If you need any help, you can connect with me.

Visit:- Vaibhav Jaiswal

docubox-androidapp's People

Contributors

hellosagar avatar ishantchauhan710 avatar vaibhav2002 avatar yogesh-7 avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    πŸ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. πŸ“ŠπŸ“ˆπŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❀️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.