Skip to content

Commit 591573a

Browse files
updated readme
1 parent 4a492c0 commit 591573a

File tree

1 file changed

+164
-2
lines changed

1 file changed

+164
-2
lines changed

README.md

+164-2
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,165 @@
1-
# yliw
1+
<p align="center">
2+
<img width=200px height=200px src="assets/images/yliw.png" alt="YLIW logo"/>
3+
</p>
24

3-
A new Flutter project.
5+
<h3 align="center"> Your Life In Weeks </h3>
6+
7+
8+
<div align="center">
9+
10+
[![Platform](https://img.shields.io/badge/platform-Android%20%7C%20iOS%20%7C%20Linux%20%7C%20Windows%20%7C%20MacOS%20%7C%20Web-lightgrey)][release]
11+
</div>
12+
13+
<div align="center">
14+
15+
[![GitHub Stars](https://img.shields.io/github/stars/DattatreyaReddy/yliw)](https://github.com/DattatreyaReddy/yliw)
16+
[![GitHub License](https://img.shields.io/github/license/DattatreyaReddy/yliw)](https://github.com/DattatreyaReddy/yliw/blob/main/LICENSE)
17+
![CI](https://github.com/DattatreyaReddy/yliw/actions/workflows/publish.yml/badge.svg)
18+
[![stable release](https://img.shields.io/github/release/DattatreyaReddy/yliw.svg?maxAge=3600&label=download)](https://github.com/DattatreyaReddy/yliw/releases)
19+
20+
</div>
21+
22+
23+
24+
<p align="center">
25+
A free and open source life tracking app.</br></br>
26+
Based on the <a href="http://waitbutwhy.com/2014/05/life-weeks.html">Your Life in Weeks</a> post by Tim Urban, from <a href="http://waitbutwhy.com/">Wait But Why</a>.
27+
</br></br>
28+
YLIW supports Linux, Windows, MacOS, Web, iOS and Android.
29+
</p>
30+
31+
---
32+
33+
## Downloading and Running the app
34+
35+
### Android
36+
37+
Download *-android-all.apk file from latest release [the releases section][release].
38+
39+
40+
### iOS
41+
42+
- Download the latest .ipa file from [the releases section][release]
43+
- use [AltStore](https://altstore.io/) to install YLIW in ios.
44+
45+
### Windows
46+
47+
Download the latest .msi file from [the releases section][release].
48+
49+
<!-- if you use WINGET, you can run
50+
```
51+
winget install yliw
52+
``` -->
53+
54+
### MacOS
55+
56+
- Download the *-macos-x64.zip from the latest release [the releases section][release]
57+
- Extract the file.
58+
- Drag and drop the extracted app file to applications folder in finder.
59+
60+
<!-- if you use HomeBrew, you can run
61+
```
62+
brew install --cask yliw
63+
``` -->
64+
65+
### Debian based Linux
66+
67+
Download the latest deb release from [the releases section][release].
68+
69+
<!-- ### Arch based Linux
70+
71+
Download the latest release from [the aur](https://aur.archlinux.org/packages/yliw-bin).
72+
73+
If you use yay, you can run
74+
```
75+
yay -S yliw-bin
76+
```
77+
inside a terminal window. -->
78+
79+
### Web
80+
81+
Download the latest web.zip file from [the releases section][release].
82+
83+
- YLIW-web deployed in GitHub pages. You can check out [YLIW here](https://dattatreyareddy.github.io/yliw/).
84+
85+
86+
## Building from source
87+
88+
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.
89+
90+
### Prerequisites
91+
92+
You can install Flutter & Dart from [Official website](https://docs.flutter.dev/get-started/install)
93+
94+
- Dart sdk
95+
- Flutter - Channel Stable
96+
97+
### Building
98+
99+
1. Clone the repository:
100+
101+
```
102+
$ git clone https://github.com/DattatreyaReddy/yliw.git
103+
$ cd yliw/
104+
```
105+
2. You can install all dependencies by running this command in terminal:
106+
107+
```
108+
$ flutter pub get
109+
```
110+
111+
3. Now enter the following command to start debugging the app:
112+
113+
```
114+
$ flutter run
115+
```
116+
117+
- Localization generator
118+
```
119+
$ flutter gen-l10n
120+
```
121+
122+
- Pull-Request Suggestion
123+
- Install GitHooks after cloning the repo using `git config --local core.hooksPath .githooks`
124+
125+
## Support and help
126+
127+
- Raise issue in github
128+
129+
## Built Using
130+
131+
- [Flutter](https://flutter.dev/) is an open source framework by Google for building beautiful, natively compiled, multi-platform applications from a single codebase.
132+
133+
- [Flutter Riverpod](https://pub.dev/packages/riverpod/) - A simple way to access state while robust and testable.
134+
135+
Find other dependencies in [pubspec.yaml](pubspec.yaml)
136+
137+
## Credit
138+
139+
- The `YLIW` project is developed by [@DattatreyaReddy](https://github.com/DattatreyaReddy) and contributors.
140+
141+
- Based on the <a href="http://waitbutwhy.com/2014/05/life-weeks.html">Your Life in Weeks</a> post by Tim Urban, from <a href="http://waitbutwhy.com/">Wait But Why</a>.
142+
143+
<!-- ## Translation
144+
Feel free to translate the project on [Weblate](https://hosted.weblate.org/projects/DattatreyaReddy/yliw/)
145+
146+
<details><summary>Translation Progress</summary>
147+
<a href="https://hosted.weblate.org/engage/padya/">
148+
<img src="https://hosted.weblate.org/widgets/padya/-/yliw/multi-auto.svg" alt="Translation status" />
149+
</a>
150+
</details> -->
151+
152+
## License
153+
154+
You can obtain a copy of `Mozilla Public License v2.0` from https://mozilla.org/MPL/2.0/
155+
156+
157+
Copyright (c) 2024 Panta Dattatreya Reddy
158+
159+
This Source Code Form is subject to the terms of the Mozilla Public
160+
License, v. 2.0. If a copy of the MPL was not distributed with this
161+
file, You can obtain one at http://mozilla.org/MPL/2.0/.
162+
163+
164+
[release]: https://github.com/DattatreyaReddy/yliw/releases
165+
[yliw]: https://github.com/DattatreyaReddy/yliw

0 commit comments

Comments
 (0)