Skip to content

Commit

Permalink
docs: added Readme
Browse files Browse the repository at this point in the history
  • Loading branch information
arteevraina committed Apr 30, 2022
1 parent 2e2564b commit 556c758
Showing 1 changed file with 55 additions and 10 deletions.
65 changes: 55 additions & 10 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,61 @@
# reador
![Reador](https://socialify.git.ci/arteevraina/Reador/image?forks=1&issues=1&language=1&name=1&owner=1&pulls=1&stargazers=1&theme=Light)

A new Flutter project.
# Reador

## Getting Started
## Inspiration

This project is a starting point for a Flutter application.
I love to read books but when I cannot keep track of my readings, I end up reading multiple books and could not complete one book completely.

A few resources to get you started if this is your first Flutter project:
## What it does

- [Lab: Write your first Flutter app](https://flutter.dev/docs/get-started/codelab)
- [Cookbook: Useful Flutter samples](https://flutter.dev/docs/cookbook)
This Android application will help you adding your current books that you are going to read and also helps to keep the track of the pages you have read. Basically, it tells us about the percentage of the book read so far. It also has a Dark and Light Theme.

For help getting started with Flutter, view our
[online documentation](https://flutter.dev/docs), which offers tutorials,
samples, guidance on mobile development, and a full API reference.
## How we built it

I build this application using Flutter Framework with Provider as the state management in about 5 hours and Hive Database as local storage.

## Challenges we ran into

I ran into many challenges :

1. I was unable to figure out how to swap two indexes in local hive storage.

## Accomplishments that we're proud of

1. I was able to create MVP application that can be released on to the playstore.
2. I coded this application from scratch alone in 5 hours.

## What we learned

1. I learned about Provider.
2. I learned about Reorderable ListView.
3. I learned about Hive Storage.

## What's next for Reador

1. Integrate ReorderableListView with local database and I can then reorder my learnings.
2. Add a feature to start the best reads so that I can read them again and again (This is already done).

## How to setup locally ? 🏁

1. Fork the repository.

2. Clone the repository using the following command.

```
https://github.com/<your-user-name>/Reador.git
```

3. Open the code in your favorite code editor.

4. Install the dependencies using the following command:

```
$ flutter pub get
```

5. Build the app using the following command:

```
$ flutter run
```

0 comments on commit 556c758

Please sign in to comment.