Cory McWilliams
85fce59c0c
All checks were successful
Build Tilde Friends / Build-All (push) Successful in 19m17s
|
||
|---|---|---|
| .gitea/workflows | ||
| apps | ||
| core | ||
| deps | ||
| docs | ||
| metadata/en-US | ||
| src | ||
| tools | ||
| .clang-format | ||
| .dockerignore | ||
| .git-blame-ignore-revs | ||
| .gitignore | ||
| .gitmodules | ||
| .prettierignore | ||
| .prettierrc.yaml | ||
| CONTRIBUTING.md | ||
| default.nix | ||
| Dockerfile | ||
| Doxyfile | ||
| flake.lock | ||
| flake.nix | ||
| GNUmakefile | ||
| LICENSE | ||
| package-lock.json | ||
| package.json | ||
| README.md | ||
Tilde Friends
Tilde Friends is a tool for making and sharing.
A public instance lives at https://www.tildefriends.net/.
It is both a peer-to-peer social network client, participating in Secure Scuttlebutt, as well as a platform for writing and running web applications.
Goals
- Make it easy and fun to run all sorts of web applications.
- Provide security that is easy to understand and protects your data.
- Make creating and sharing web applications accessible to anyone with a browser.
Building
Builds on Linux (x86_64 and aarch64), MacOS, OpenBSD, and Haiku. Builds for all of those host platforms plus mingw64, iOS, and android.
Tilde Friends uses git submodules, so either:
git clone --recurse-submodules https://dev.tildefriends.net/cory/tildefriends.git
or:
git clone https://dev.tildefriends.net/cory/tildefriends.git
cd tildefriends
git submodule update --init --recursive
The .tar.xz releases are all-inclusive.
The gitea Source Code (ZIP) and Source Code (TAR.GZ) are missing
dependencies, so don't use those.
- On Linux only, system OpenSSL libraries (
libssl-dev, in debian-speak) is assumed to be available. - To build, run
make debugormake release. An executable will be generated in a subdirectory ofout/. - It's possible to build for Android, iOS, and Windows on Linux, if you have
the right dependencies in the right places.
make windebug winrelease iosdebug-ipa iosrelease-ipa release-apk. - To build in docker,
docker build .. make formatwill normalize formatting to the coding standard.
Running
By default, running the built tildefriends executable will start a web server
at http://localhost:12345/. tildefriends -h lists further options.
The first user to create an account and log in will be granted administrative privileges. Further administration can be done at http://localhost:12345/~core/admin/.
Documentation
Docs are a work in progress: https://www.tildefriends.net/~cory/wiki/#test-wiki/tf-app-quick-reference.
License
All code unless otherwise noted in is provided under the MIT license.