Planetary IOS is an app based on Secure Scuttlebutt that doesn't keep your data in the cloud and allows you and your friends to come together and connect even when the internet goes out.
Check our website planetary.social for more info!
The repo does have some Carthage and Cocoapod dependencies, however all except one have been versioned and checked into the repo.
When running pod install
(or pod install --no-repo-update) you will be prompted to enter some secrets. Enter
nil` for all of them or request current values at: https://planetarysupport.zendesk.com/hc/en-us/requests/new.
While this project uses Go in parts, the build and unit test target have automated install scripts for the specific versions. See Go Development for more.
The app can run completely in the iOS simulator. If you want to run it on a device, your Apple ID must be part of the Verse Apple Developer team. Contact contact@verse.app if you need access.
For now master
is the main branch and code improvements are made in topic branches that get merged into it. Eventually there will be specific release branches, but for now master
is the release branch.
- Create a branch named
initials-topic
or ticket tag likeesw-190
- dd commits at whatever pace/detail necessary (these are mostly for your benefit)
- Push your named branch
- Add a short description of what the PR accomplishes
- If possible add screenshots (use shift-command-4-space-click to capture the iOS simulator window)
Due to the small team size, code reviews are mostly to inform other members what's going on. Use GitHub's inline comment feature to leave notes for others to read and reply.
- Select "Squash and merge" from the drop-down Merge button.
- Delete the branch (as the UI recommends) to keep the repo clean.
Installation in the xcode targers is automated. See FBTT/Scripts/go_install.sh
for which compiler version is used by XCode.
We are using vendoring to keep a copy of the dependencies in this repo. Therefore each module update (go get github.com/some/import/...@version
) needs to be followed by running go mod vendor
and commiting the resulting changes.
If you have a seperate Go installation, run the following script to test that everything works as intended run
export GOROOT=$(go env GOROOT)
test -d $GOROOT || exit 1 # the makefile needs GOROOT to be set
cd FBTT/go-ssb-bindings
make
ls out/libssb-go.a`
ps: If you are already using Homebrew you can also use brew install go
instead of the installer from golang.org