https://github.com/evcc-io/app
native evcc app frame for iOS (and Android)
https://github.com/evcc-io/app
Last synced: 3 months ago
JSON representation
native evcc app frame for iOS (and Android)
- Host: GitHub
- URL: https://github.com/evcc-io/app
- Owner: evcc-io
- License: mit
- Created: 2024-02-16T17:10:11.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-08-19T20:15:58.000Z (10 months ago)
- Last Synced: 2024-10-30T03:25:32.438Z (8 months ago)
- Language: TypeScript
- Homepage: https://evcc.io/
- Size: 6.49 MB
- Stars: 7
- Watchers: 7
- Forks: 5
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# evcc Companion App
Native app wrapper for evcc UI based on [react-native](https://reactnative.dev/) and [expo.dev](https://expo.dev/). It uses [UI Kitten / Eva](https://akveo.github.io/react-native-ui-kitten/) as a design system. Native parts are written in TypeScript and kept to a minimum.
## Download the App
- [Apple App Store](https://apps.apple.com/de/app/evcc-io/id6478510176)
- [Google Play Store](https://play.google.com/store/apps/details?id=io.evcc.android)
## Beta Testing
- Apple Testflight https://testflight.apple.com/join/8Y4elMpv
- Android: Download the APK from [GitHub Releases](https://github.com/evcc-io/app/releases)
## Features
- Onboarding
- find evcc instances in local network via mDNS
- add instance manually via URL
- try the app using the demo instance
- Full screen evcc UI
- use the app in a full screen web view
- UI runs in an optimized mode that respects insets (notch, ...)
- better gesture support (swipe, ...) by disabling browser zoom and overscroll
- Online/offline detection
- app shows loading screen when instance is not reachable
- automatic reconnection when instance becomes reachable again
- avoids missleading situations where the app is shown but not functional
- Configured URL can be changed
- in offline mode
- via additional top navigation entry "Change server"
- Light and dark mode for native UI
- based on system settings (not configurable)
## Screenshots
## Known limitations
- No support for multiple instances [#3](https://github.com/evcc-io/app/issues/3)
- mDNS discovery only supports HTTP [#1](https://github.com/evcc-io/app/issues/1)
We'll work on these in a future release. Feel free to vote 👍 to help priorization and add new feature ideas.
## Development
Ensure that you've Node.js and NPM installed. Then install the dependencies:
```bash
npm install
```
Follow the expo instructions to run local simulators for [iOS](https://docs.expo.dev/workflow/ios-simulator/) and [Android](https://docs.expo.dev/workflow/android-studio-emulator/).
Start dev mode to get into an interactive development environment.
```bash
npm run start
```
Or start iOS, Android or Web simulator directly.
```bash
npm run ios
npm run android
npm run web
```
You can test basic auth locally by with a [caddy server](https://caddyserver.com):
```bash
caddy run
```
It will open a server on http://localhost:7080 with `admin:secret` as basic auth credentials and forward requests to your local evcc instance 7070.
## Translation
We use [Weblate](https://hosted.weblate.org/projects/evcc/app/) to manage our translations.
[](https://hosted.weblate.org/engage/evcc/)