Meet StencilBox: A Simple Way to Build Super Speedy Static Sites from YAML

A new tool for self-hosters, sysadmins, and developers

I’m excited to share with you a new project that I think has the potential to make a big impact on the way we build and manage static sites. It’s called StencilBox, and it’s a tool that allows you to build super speedy static sites from YAML files. But before I dive into the details, let me tell you a bit about why I’m so excited about this project.

I’ve been working on various projects over the years, including OliveTin, and I’ve always been passionate about creating tools that make it easy for people to build and manage their own websites. With StencilBox, I wanted to create a tool that would allow self-hosters, sysadmins, and developers to build static sites quickly and easily, without having to worry about complicated setup or maintenance.

What can you use StencilBox for?

So, what can you use StencilBox for? Well, as a self-hoster, you can use it to create a “homepage” of links that you can easily update from YAML, and that loads super quickly in the browser. As a sysadmin, you can use it to give your users a simple way to create pages without needing to know about Git, worry about tooling, or hosting. And as a developer, you can use it to render data in YAML format to a nice-looking webpage.

StencilBox comes with three built-in templates, including a links homepage, an iframe sidebar, and a service status page. You can also add more templates via Git repos, which makes it easy to customize and extend the tool to fit your needs.

How does it work?

StencilBox is packaged exclusively as a Docker container, which makes it easy to install and run. It’s built on the Alpine base image, which means it’s lightweight and efficient. In my testing, RAM usage rarely exceeds 100mb, which is great news for those of us who are concerned about resource usage.

To get started with StencilBox, you can use Docker Compose, which provides a simple way to define and run multi-container Docker applications. You’ll need to create a persistent volume for your StencilBox configuration, but that’s about it. There are no databases or other supporting containers required, which makes it easy to get up and running quickly.

AI usage declaration

I know that some of you may be concerned about AI usage in your tools, so I want to be upfront about how StencilBox uses AI. The short answer is that it doesn’t use AI at all. The code is written and maintained by humans, and while we may use AI code suggestions to speed up typing, the code itself is entirely human-generated.

We also use linters, code review tools, and other tools that are enabled by AI, but these are optional and not required for the build process. And at runtime, StencilBox doesn’t use any AI models or send any data to AI services, so you can rest assured that your data is safe and private.

No-nonsense software principles

StencilBox is built on a set of no-nonsense software principles that I think are important for any tool. First, it’s open source and free software, which means that all the code and assets are available under the AGPL-3.0 License. This ensures that the tool is transparent, customizable, and free from proprietary restrictions.

Second, StencilBox is independent, which means that no company owns the code or is responsible for the project’s governance. This ensures that the tool is free from commercial interests and can be developed and maintained by the community.

Third, StencilBox is inclusive, which means that there’s no “core”, “pro”, “premium”, or “enterprise” version. The only version is the one you can download and run, and it has all the features. This ensures that everyone has access to the same tool, regardless of their budget or resources.

Finally, StencilBox is invisible, which means that it doesn’t track usage, collect user data, or display ads. It’s also internal, which means that it doesn’t require an internet connection to function. This ensures that your data is safe and private, and that you can use the tool even when you’re offline.

Conclusion

That’s StencilBox in a nutshell. I’m excited to share this tool with you, and I hope you’ll find it useful for building and managing your static sites. If you have any questions or feedback, please don’t hesitate to reach out. And if you’re interested in contributing to the project, I’d love to have you on board.

Thanks for reading, and I hope you’ll give StencilBox a try!

Poznaj StencilBox: Prosty sposób budowania super szybkich statycznych stron internetowych z YAML

Narzędzie dla self-hosterów, administratorów systemów i deweloperów

Ciesze się, że mogę podzielić się z wami nowym projektem, który myślę, że ma potencjał aby znacznie wpłynąć na sposób, w jaki budujemy i zarządzamy statycznymi stronami internetowymi. Nazywa się StencilBox i jest to narzędzie, które pozwala budować super szybkie statyczne strony internetowe z plików YAML. Ale zanim przejdę do szczegółów, chciałbym powiedzieć trochę o tym, dlaczego jestem tak podekscytowany tym projektem.

Pracowałem nad różnymi projektami przez lata, w tym OliveTin, i zawsze byłem pasjonatem tworzenia narzędzi, które ułatwiają ludziom budowanie i zarządzanie własnymi stronami internetowymi. Z StencilBox, chciałem stworzyć narzędzie, które pozwoli self-hosterom, administratorom systemów i deweloperom budować statyczne strony internetowe szybko i łatwo, bez konieczności martwienia się o skomplikowaną konfigurację lub utrzymanie.

Czego można użyć StencilBox?

Więc, czego można użyć StencilBox? No cóż, jako self-hoster, możesz użyć go do stworzenia “strony głównej” linków, które można łatwo aktualizować z YAML, i które ładują się bardzo szybko w przeglądarce. Jako administrator systemu, możesz użyć go do udostępnienia użytkownikom prostego sposobu tworzenia stron bez konieczności znajomości Git, martwienia się o tooling lub hosting. A jako deweloper, możesz użyć go do renderowania danych w formacie YAML do ładnej strony internetowej.

StencilBox posiada trzy wbudowane szablony, w tym stronę główną linków, iframe boczną i stronę statusu usługi. Możesz również dodać więcej szablonów za pomocą repozytoriów Git, co ułatwia dostosowanie i rozwinięcie narzędzia do Twoich potrzeb.

Jak to działa?

StencilBox jest opakowany wyłącznie jako kontener Docker, co ułatwia instalację i uruchomienie. Zbudowany jest na obrazie Alpine, co oznacza, że jest lekki i wydajny. W moich testach, użycie pamięci RAM rzadko przekracza 100mb, co jest dobrą wiadomością dla tych z nas, którzy są zaniepokojeni użyciem zasobów.

Aby rozpocząć pracę ze StencilBox, możesz użyć Docker Compose, który zapewnia prosty sposób definiowania i uruchamiania aplikacji Docker z wieloma kontenerami. Musisz utworzyć trwały wolumin dla konfiguracji StencilBox, ale to wszystko. Nie ma wymaganych baz danych ani innych kontenerów wspierających, co ułatwia szybkie rozpoczęcie pracy.

Oświadczenie o użyciu AI

Wiemy, że niektórzy z was mogą być zaniepokojeni użyciem AI w waszych narzędziach, więc chciałbym być otwarty o tym, jak StencilBox używa AI. Krótko mówiąc, nie używa on AI wcale. Kod jest napisany i utrzymywany przez ludzi, a chociaż możemy używać sugestii kodu AI, aby przyspieszyć pisanie, sam kod jest w całości generowany przez ludzi.

Także używamy linterów, narzędzi do przeglądu kodu i innych narzędzi, które są włączone przez AI, ale są one opcjonalne i nie są wymagane do procesu budowania. A podczas wykonywania, StencilBox nie używa żadnych modeli AI ani nie wysyła żadnych danych do usług AI, więc możecie być spokojni, że wasze dane są bezpieczne i prywatne.

Zasady oprogramowania bez nonsensu

StencilBox jest zbudowany na zasadach oprogramowania bez nonsensu, które myślę, są ważne dla każdego narzędzia. Po pierwsze, jest to oprogramowanie otwarte i bezpłatne, co oznacza, że cały kod i zasoby są dostępne na licencji AGPL-3.0. To zapewnia, że narzędzie jest przejrzyste, dostosowywalne i wolne od ograniczeń własnościowych.

Po drugie, StencilBox jest niezależny, co oznacza, że żadna firma nie posiada kodu ani nie jest odpowiedzialna za zarządzanie projektem. To zapewnia, że narzędzie jest wolne od interesów handlowych i może być rozwijane i utrzymywane przez społeczność.

Po trzecie, StencilBox jest inkluzywny, co oznacza, że nie ma “rdzenia”, “pro”, “premium” ani “entreprise” wersji. Jedyna wersja to ta, którą możesz pobrać i uruchomić, i posiada wszystkie funkcje. To zapewnia, że każdy ma dostęp do tego samego narzędzia, niezależnie od budżetu lub zasobów.

Wreszcie, StencilBox jest niewidzialny, co oznacza, że nie śledzi użycia, nie gromadzi danych użytkowników ani nie wyświetla reklam. Jest także wewnętrzny, co oznacza, że nie wymaga połączenia z internetem, aby działać. To zapewnia, że wasze dane są bezpieczne i prywatne, i że możecie używać narzędzia nawet gdy jesteście offline.

Podsumowanie

To jest StencilBox w skrócie. Ciesze się, że mogłem podzielić się z wami tym narzędziem, i mam nadzieję, że znajdziecie je użytecznym do budowania i zarządzania statycznymi stronami internetowymi. Jeśli macie jakieś pytania lub uwagi, proszę nie wahajcie się skontaktować. A jeśli jesteście zainteresowani przystąpieniem do projektu, będę bardzo szczęśliwy.

Dziękuję za czytanie, i mam nadzieję, że spróbujecie StencilBox!