README
¶
Hydris View
Expo/React Native monorepo for web and Android.
Prerequisites
- Go
- Bun
- Android SDK + NDK 26.1 (for Android)
Setup
From the repo root:
make setup
Web
No Android SDK needed.
bun dev:web # dev server
bun build:web # production build
bun build:web:staging # staging build
bun serve # serve production build
Android
The first Android build requires make android from the repo root — this compiles the Go native libraries and produces a release APK:
# from repo root
make android
APK output: view/apps/foss/android/app/build/outputs/apk/release/app-release.apk
After the initial build, frontend-only changes can be iterated with:
bun dev:android # debug build + Metro dev server
Remote vs Native Backend
The APK always includes the native engine, but it only starts if no remote backend URL is configured (EXPO_PUBLIC_HYDRIS_API_URL).
Remote backend — engine runs on your dev machine:
adb reverse tcp:50051 tcp:50051
Set EXPO_PUBLIC_HYDRIS_API_URL=http://localhost:50051 in .env.development. The native engine stays idle.
Native backend — engine runs on device via AAR:
Leave EXPO_PUBLIC_HYDRIS_API_URL unset. To push test data from your machine to the device:
adb forward tcp:50051 tcp:50051
| Command | Direction | Use case |
|---|---|---|
adb reverse |
device → host | Remote backend on your machine |
adb forward |
host → device | Native backend on device |
If
adb reversefails with "Address already in use", the native backend may be running. Force stop the app first:adb shell am force-stop com.q.hydris # or adb reboot && adb wait-for-device && adb reverse tcp:50051 tcp:50051
Code Quality
bun lint # eslint check
bun lint:fix # eslint fix
bun format # prettier format
bun type-check # typescript check
bun test # run tests
Structure
view/
├── apps/
│ └── foss/ # app
│ └── app/ # routes
├── packages/
│ ├── core/ # shared features (aware, sensors, api, stores)
│ ├── hydris-engine/ # native module wrapping hydris.aar
│ ├── map-engine/ # map abstraction (deck.gl + maplibre)
│ ├── ui/ # shared ui components
│ ├── eslint-config/
│ └── typescript-config/
Environment Variables
cp apps/foss/env-example apps/foss/.env.development
| Variable | Description | Default |
|---|---|---|
EXPO_PUBLIC_HYDRIS_API_URL |
Backend API URL | window.location.origin |
Cluster Worker Bundle
packages/map-engine/src/layers/cluster-worker-code.ts is auto-generated — do not edit manually.
Rebuild after changing cluster-logic.ts or cluster-worker.ts:
bun run --cwd packages/map-engine bundle:worker
Troubleshooting
Clear Expo cache if you hit stale state:
bun dev --clear
Protocol Buffers
Proto types are provided by @projectqai/proto.
Documentation
¶
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func NewWebServer ¶
Types ¶
type NodeInfo ¶
type NodeInfo struct {
Hostname string `json:"hostname"`
NumCPU int `json:"num_cpu"`
GOOS string `json:"goos"`
GOARCH string `json:"goarch"`
MemAllocMB uint64 `json:"mem_alloc_mb"`
MemTotalMB uint64 `json:"mem_total_mb"`
NumGoroutine int `json:"num_goroutine"`
EntityCount int `json:"entity_count"`
}
Source Files