About ↟
The Untitled Project is basically a learning tool. Its an interactive experience that demonstrates the unstopable power of using Lisp Flavored Erlang on the backend and HTMX on the front.
Each micro lesson provides both backend and frontend code for the reader to observe and interact with while not having to setup the full stack in a safe and controlled environment.
This project was created as a spawnfest entry, if you are a judge, you may want to look at the spawnfest-manifest which outlines about the project and its boundaries.
Rationale ↟
🚀 HTMX is not just another web development library; it's pure web development magic! Think of it as your secret potion to create dynamic, interactive, and fast web applications with minimal effort. No "React" in sight, no frameworks. We bring the "Hype" back into Hyper Text Markup Language. When you couple HTMXs magic with the unstoppable terminator mindset of BEAM supervised processes, industrial grade magic is within reach.
HTMX simplifies the development of Single Page Applications (SPA, apparently web pages are apps). It does most of the common webappy stuff with markup instead of writing oodles of javascript.
Lisp Flavored Erlang has tickled my fancy for a while. I haven't had enough time to really dive into the feature and use it in production. I have written common lisp and erlang for some time now, deploying both into production.
Erlang is the T-800 terminator of programming languages, when its hit or crashes it just gets right back up. Lisp Flavored Erlang provides alien technology to Erlang raising the bar once again.
This version of TBWLE (Untitled Project) intends to demonstrate HTMX and LFE, I will continue to feed my learning back into this project as I learn new skills.
It would be great if people could also contribute to this project to foster a learning community around LFE and HTMX.
Submitting bugs ↟
This project accepts bugs and features using github issues, you can lodge one here
Bugs and features will be fixed when I can. Pull Requests, are also it accepted will make my life a lot easier. Github actions are configured on this repostiory, when cloning this repo, please make sure that the current tests pass.
Build ↟
This program is tested and developed on Linux, it may not work on other platforms.
$ rebar3 compile
$ rebar3 lfe compileStart the Project REPL ↟
$ rebar3 lfe repl
lfe> (untitled_project:start)Open http://localhost:8888 in your web browser and begin reading.
$ rebar3 lfe runOpen http://localhost:8888 in your web browser and begin reading.
Tests ↟
$ rebar3 lfe ltest -tall Usage ↟
$ rebar3 lfe runVisit http://localhost:8888 in your browser.
Roadmap ↟
☑ Create a tutorial of basic HTMX used with LFE.
☑ Provide a simple working LFE web server that serves html.
☑ Provide an example of serving htmx from LFE.
☑ Use Lanes as the router (less hassle than current)
☑ - Add github actions for quick test results.
☑ Add github action to create container
☑ Create a playground which serves up simple editable html page and a lfe handler.
Post Spawnfest
☐ Publish a container.
☐ Update instructions on how to run container.
☐ Implement all examples on the HTMX.org examples page.
☐ Implement examples of routing specific htmx features to gen-server processes.
☐ Demonstrate emacs workflow at repl.
☐ Provide advanced examples of per user processes linked to a single page (advanced, probably after spawnfest).
☐ Create "export" of custom sandbox function for use in users project.
☐ Implement the "debug" HTMX extension on all pages.
License ↟
Apache License, Version 2.0
Copyright © 2023, Wade Mealing wmealing@gmail.com.