.gitea/workflows | ||
apps | ||
core | ||
deps | ||
docs@47f91bd302 | ||
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
source releases are all-inclusive.
- On Linux only, system OpenSSL libraries (
libssl-dev
, in debian-speak) are assumed to be available. - Run
make
with no arguments to see available build targets and options.make debug
is a good place to start. - It's possible to build for Android, iOS, and Windows on Linux, if you have the right dependencies in the right places.
- To build in docker,
docker build .
. make format
will 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.