1### Cerrado
 2
 3Self host single user forge.
 4
 5You can find a running instance here:
 6
 7https://beta.gabrielgio.me
 8
 9### Goals
10
11Keep it simple and lightweight, that includes the application itself,
12development process and the deployment.
13
14The application requires no javascript to run, and it is light and fast to
15render.
16
17This project is also easy to iterate on. There are only two dev dependencies: go
18and sassc so it compiles fast. Codewise it strives for easy to understand.
19Easy to read code is better than clever.
20
21The deployment process should be easy to wrap the head around and
22straightforward to set up. To achieve that it uses a simple file format[^1] to
23configure everything. Also to reduce the moving parts the whole application,
24including its statics files, is bundled into a single binary.
25
26To run the project you just need to `make run`.
27
28### Installations
29
30One installation process available is through my apk repository[^2][^3].
31
32You could also run:
33
34```sh
35make
36make install
37```
38
39Or you could also pick another prefix:
40
41```sh
42PREFIX=$HOME/.local/ make install
43```
44
45You can check openrc files for the details how it is run with a init system,
46but in general you'd need the cerrado binary and scfg file, which can easily be
47integrated with systemd.
48
49### Contributing
50
51To discuss about the project send me a email or write an issue on codeberg[^4].
52To avoid duplicated work or to work something I might not take in, I'd
53recommend to reach me before doing something.
54
55To contribute code feel free to create a PR on codeberg or send me an
56email-patch[^5].
57
58My email:
59
60mail@gabrielgio.me
61
62### TODO
63
64- dark theme that does not require js
65- dark theme support for systax highlight configuration
66    - we should be able to generate css from both theme and provide as an
67      endpoint.
68
69### Ideas
70
71- Code snippet support
72- Setup manual (man feature perhaps?)
73- Add metrics
74- Add reference based cache system. Cerrado should be able to cache the whole
75  page based on its reference hash
76
77### Future
78- Mail patch / mailing list. This is very complex endeavour. In a distant
79  future I might do it, but for now I will focus on the features listed above.
80
81[^1]: https://git.sr.ht/~emersion/scfg
82[^2]: https://apkdoc.gabrielgio.me/
83[^3]: https://git.gabrielgio.me/apkbuilds/
84[^4]: https://codeberg.org/gabrielgio/cerrado/issues
85[^5]: https://git-send-email.io/