reunicorn

KO | EN

gitlite — search

#javascript #react #llm #golang #go #rust #linux #nodejs #awesome #awesome-list #vue #pytorch #mcp #openai

(★ 26)

Where & how to get in contact, shared securely and privately, powered by Veilid.

reunicorn 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Reunicorn

Reunicorn is a smartphone app to synchronize contact details and share current as well as future locations in a privacy preserving manner for everyone who wants to stay in touch with their peers.

When you plan to visit a city, find out immediately who of your old friends you could meet and directly contact them with up-to-date contact details.

**Features:**
- You can connect with existing contacts in an end-to-end encrypted manner to securely and privately keep each others' contact details up-to-date, right in your smartphone's address book.
- As soon as your contacts start sharing their addresses, current or future locations, you can see them on a map to plan your travels and coordinate meeting people you care about.
- You can personalize what you share with whom so that colleagues, friends and lovers each stay up-to-date on what you want them to know and nothing else.

This [Flutter](flutter.dev) based implementation is derived from [VeilidChat](https://gitlab.com/veilid/veilidchat/).
Accordingly, the Copyright to all code files belongs to the Veilid developers licensed under MPL-2.0 unless explicitly stated otherwise.

The map style files `assets/map-style-*.json` originate from https://maps.protomaps.com, so the Copyright belongs to them.

## Building an APK from source

To build an APK locally, you only need Docker:

```
git clone <this repository> && cd reunicorn
./docker/build-apk.sh
```

which generates: `build/app/outputs/flutter-apk/app-release.apk` (signed with a debug key unless you provide `android/key.properties`)

To pass a MapTiler token into the build, or to run the tests instead:

```
REUNICORN_MAPTILER_TOKEN=<token> ./docker/build-apk.sh
./docker/build-apk.sh test
./docker/build-apk.sh shell     # interactive shell in the build environment
```

## Development Setup

The container above can also be used with the [Dev Containers extension](https://code.visualstudio.com/docs/devcontainers/containers), "Reopen in Container" gives you the pinned toolchain and the matching Veilid checkout with no host setup; `.devcontainer/devcontainer.json` reuses the same `docker/Dockerfile` that is built in CI/CD.

If you are working on Reunicorn and Veilid together, point the container at your own checkout:

```
VEILID_SRC=../veilid ./docker/build-apk.sh
```

For a native setup instead, you need

- Flutter (see `docker/versions.env`)
- Android SDK/NDK (see `docker/versions.env`)
- Rust (see `docker/versions.env`)
- [Veilid](https://gitlab.com/veilid/veilid/) source checked out at `../veilid` relative to this repository (check `docker/check-versions.sh` for exact veilid version)

For the address search and geocoding to work, you need to provide the environment variable `REUNICORN_MAPTILER_TOKEN` with an API token that can be obtained for free from maptiler.com.
This is a compile-time value (`String.fromEnvironment`), so it has to be set when you build, not just when you run.

### Running on a device

```
flutter clean
flutter pub get
flutter run -d <DEVICE-ID>
```

To (re-)generate all code from templates, run
```
dart run build_runner build
```

To (re-)generate all app icons, run
```
dart run icons_launcher:create
```

### Fastlane

On MacOS, use brew to install fastlane.

Then run fastlane in the `ios/` or `android/` subfolder.

### Testing

Using `lcov`, run:
```
flutter test --coverage
genhtml coverage/lcov.info -o coverage/html
open coverage/html/index.html

```

### WidgetBook

Start this script to re-build and run WidgetBook in Chrome:
```
./widgetbook/run.sh
```

### Gradle Version Upgrades

- https://gradle.org/releases/
- https://developer.android.com/build/releases/about-agp#updating-gradle

### Fastlane

For Fastlane setup see https://docs.fastlane.tools/

Based on the Gemfile of this repo, you can get fastlane with
```
bundle update
```

### Misc

For iOS when changing e.g. the `IPHONEOS_DEPLOYMENT_TARGET`, cd into `ios/` and run `pod update`.

## Original User Stories

These where the initial user stories written before the development of Reunicorn began.
They serve as a reminder and reference to what experience we aim to achieve.

### Open app first time

I'd like to set up my profile with all the contact information I want to publish.
I'd like to define different scopes that can see different subsets of my contact information to shape what is shared with others.

I'd like to see my contacts list with all already securely connected contacts that also have the app.
If that's not possible, see highlighted / at top who has the app - not connected yet.
If that's not possible, can I at least see most of them after I've connected with the first peer?

### Connect

When I click on a contact that I haven't shared with yet, I'd like to see a share menu for all encrypted messengers where I can share the sharing link.

When my contact accepts the invitation and shares with me, I'd like to see that highlighted.

When someone sends me a share code, I'd like to click on it and have the app automatically pick it up. It should then also ask me if I want to share back and if I say yes automatically do so.

After sharing is recognized in the app, I'd like the respective information to be updated.

### See the map

I'd like to see a map where all the locations of my contacts are displayed.
Locations by the same contact should be visually grouped somehow?!

When I click on a pin on the map I'd like to see their name
when I zoom close enough I might also already want to see the initials or name

### Recovery

When I loose my phone, I'd like to be able to tell four of my trusted contacts.
They should then send me a message, which opens in the app. And after I've received all four, everything should be restored.

### My updates

When I update my profile, I'd like all contacts I've shared with to receive the updated information without any unauthorized 3rd party being able to see the update or tie my social network to me / infer the social network.
I'd like to also see which of my contacts already received my update.

### Unshare

When I decide to stop sharing with someone, I'd like them not not be notified and for them to stop receiving any future updates.

### Others updates

When ever someone else updates their profile, I'd like to get all the information, even if I'm not online at the same time and without unauthorized parties seeing the details.

### Higher avail / federation

I would like to set up an always on node that I can configure to replicate everything my mobile node replicates.

### Privacy

I'd like nobody to be able to discover my social graph or the contact details I share if they are not intended for them.
I'd also like to remain anonymous to the peers I do not share my contact details with.

## App links

Scan QR code  
-> `/c/#name~typedRecordKey~psk`

Click/paste profile link  
-> `/p/#name~pubKey`

Click/paste profile based invite offer  
-> `/o/#name~typedRecordKey~pubKey`

Click/paste batch invite  
-> `/b/#label~typedRecordKey~psk~subkeyIndex~subkeyWriter`

reunicorn

reunicorn 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

reunicorn

reunicorn 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README