Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/said-alisic/plany
Plany. A small mobile application built with React Native and Expo.
https://github.com/said-alisic/plany
Last synced: 12 days ago
JSON representation
Plany. A small mobile application built with React Native and Expo.
- Host: GitHub
- URL: https://github.com/said-alisic/plany
- Owner: Said-Alisic
- License: mit
- Created: 2023-11-28T17:21:03.000Z (about 1 year ago)
- Default Branch: dev
- Last Pushed: 2024-01-22T13:26:54.000Z (about 1 year ago)
- Last Synced: 2024-01-23T15:02:33.225Z (about 1 year ago)
- Language: TypeScript
- Size: 13.6 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Plany
Plany is a small mobile application built with React Native and Expo.
## Overview
Plany is designed to provide users with calendar event tracking functionalities.
## Requirements
- Node version `20.3.1`
- [pnpm](https://pnpm.io/installation) version `8.14.0` or higher
- Android Studio or XCode to build and run the app on your device## Setup
To get started with Plany, follow these steps:
1. **Clone the repository:**
```bash
git clone https://github.com/Said-Alisic/Plany.git
cd plany
```2. **Install dependencies:**
```bash
pnpm install
```3. **Run the application:**
**iOS**
```bash
pnpm run ios
```**Android**
```bash
pnpm run android
```π‘ This will start the Expo server in your terminal. You can then run the app on an emulator or scan the QR code with the Expo Go app on your mobile device.
> β οΈ You may need to open your emulator yourself if Expo doesn't do it automatically or it fails to run the first time before the emulator opens.
## Features
βοΈSome features are missing business logic and only have dummy implementations ready.
### Sign In
https://github.com/Said-Alisic/Plany/assets/45482255/3af979ee-df6f-4ff9-bc96-b8b7858f70e6
[Sign In feature video](./docs/images/PlanySignInVideo.mov)
Signing in using email and password. Additionally, possible to sign in using a social provider such as Gmail.
### Sign Up
https://github.com/Said-Alisic/Plany/assets/45482255/355d54af-d50a-4d22-aa48-179930ca55c8
[Sign Up feature video](./docs/images/PlanySignUpVideo.mov)
Signing up using email and password. Additionally, possible to sign up using a social provider such as Gmail.
### Calendar
https://github.com/Said-Alisic/Plany/assets/45482255/08d96cfe-23e0-4a13-af7f-1dd315420880
[Calendar feature video](./docs/images/PlanyCalendarVideo.mov)
Checking events through a calendar. Creating new and deleting existing events in addition to displaying detailed event information for selected events.
### Settings
https://github.com/Said-Alisic/Plany/assets/45482255/71aaddd1-fd20-4c6e-86e8-a6e6fd3bc236
[Settings feature video](./docs/images/PlanyCalendarVideo.mov)
Adjusting application settings, such as language, dark or light mode, and enabling or disabling notifications.
## Upcoming features β¨
| Feature | Type | Status |
| ------------------------------------------- | :---------: | :------------: |
| Authentication through API | `feat` πΈ | In progress π‘ |
| Create new calendar event | `feat` πΈ | In progress π‘ |
| Add participants to existing calendar event | `feat` πΈ | Planning βͺοΈ |
| Add component tests with Cypress | `test` π | Planning βͺοΈ |
| Setup continuous integration tests workflow | `ci` π‘ | Planning βͺοΈ |
| Delete existing calendar event | `feat` πΈ | Planning βͺοΈ |
| Remove calendar event participant(s) | `feat` πΈ | Planning βͺοΈ |
| Beautified calendar events section | `design` π | In progress π‘ |
| Access calendar event information | `feat` πΈ | Planning βͺοΈ |
| Create custom app colour theme | `design` π | Planning βͺοΈ |## License
Plany is open-source software licensed under the [MIT License](LICENSE).