Liquid VS craftsman

Liquid is a template language created by shopify. In my use case I use it for generate html that is almost similar looking but differs in data. So when iterating over my HTML, I need to preview the changes I made combined with my data.

Inside the blog directory, create an index.liquid file. This will be our blog’s homepage. Eleventy provides a number of options when selecting a template engine. For this project, we’ll use Liquid.

Templating engine: SSGs rely on templating engines to define the structure of web pages. These engines enable developers to create reusable templates and incorporate dynamic content. Popular templating engines include Liquid, Handlebars, Mustache, EJS, ERB, HAML, and Slim.

Assuming I understand the ask, I think my approach would be to have a trigger fire when a ticket's custom field is set to "add user to the application." That trigger would notify a webhook. That webhook would be set to the Organization API endpoint with a payload that uses liquid markup to add 1 to the existing Organization's value.

For example, their theme templates use Liquid, which is a html templating system for Ruby. Activemerchant also was released by Shopify, and it provides a interface to major payment providers like PayPal.

In the meantime, Liquid v4.0.4 has been released, and allows building a Jekyll site with the latest Ruby.

Liquid docs - https://shopify.github.io/liquid/

Then, let’s create the simplest template for our static Eleventy page. We’ll write it using Liquid, but since it’s so simple, it won’t take advantage of any useful templating tags for now. Let’s call it index.liquid:

Previously I have used Jekyll for blogging and it has served me well for simple blogs and static websites. Jekyll is a static site generator that relies on Markdown, Liquid, HTML, and CSS. Which means no JavaScript -- a Jamstack without the J. With GitHub Pages you can even host Jekyll sites directly from your repository.2

There’s some stuff I’d tweak on this project but it has some more advanced concepts you can check out. If you want to play around with something similar (several updates since this project) and get past the boilerplate you can check out this project.

If you’re having trouble getting started backend wise, I made a tool that can scaffold some boilerplate for you. You can also check out projects like Jason or ardalis’s clean architecture projects. Here’s one that’s a little dated but still good.

If you’re interested, something like this is a more built out project I built a while back. It’s not done and I’d change several things looking back, but it gives you an idea. If you want to try something similar you can scaffold out an api with this tool, but there are other good projects you can reference as well!

If you’re interested, I made a tool that scaffolds out an API for you. Saves us a lot of time at work and sets up a lot of the boilerplate for you. You can also customize it for yourself with whatever changes you want.

And here’s a project scaffolding tool

I’ve been building out an OSS tool that scaffolds web api boilerplate for about two years now and I’ve learned a lot throughout the process. I wanted to take an opportunity to really dog food a DDD like flow with it and came up with the sandbox project for an Accessioning model within a LIMS (essentially intake for lab orders) since I have some background there.

Lots of resources out there. You can scaffold a vertically sliced ddd project with this tool. Here’s a slightly modded example from what it produces.

About 2 years ago now, I decided to take my .NET template project a bit further and made a code scaffolding tool called Craftsman. The idea is that I can write a simple description of my project using yaml or json and get all the boilerplate set up for me so I could jump right into business logic. These files aren't a source of truth, just a description to get things started. It's getting closer to a stable v1, but it's not there yet.

I don’t think there’s one singular right way to make it good. Personally, I’ve found vertical slice architecture and DDD to encourage a very maintainable codebase. I have this project that I’ve been building and iterating on with what I’ve found works well for me.