Skip to content
Darkwave

Ethos

🚜

on a scale of skateboard to aircraft carrier, it’s a cargo van

  • it doesn’t solve EVERY problem, but it has really good solutions for the problems it does solve.

(document design desicions, guiding principles, etc)

equivalent of Toyota 4Runner / sequoia Reliable dependable useful thing that just works but is still a delight to use (good style, works real good, no bullshit)

focus on being minimal, small, lightweight, fast (performance), fast (development speed), easy & cheap to deploy

  • code should be easy to write, easy to read (easy to understand what’s happening) … basic and simple, no frills

focus on creating readable code that’s clear at a glance what it does - Accessible for non-expert users Minimal abstraction and magic Even if it’s more verbose and not the best way to do something Aiming to build something that’s pragmatic and just works Providing value, solving problems (for customers)

for creating web apps that are Reliable Maintainable Low effort Flexible Valuable - above all, highly usable and focused on solving problems for users Doing what they need to in a pleasant (joy sparking) way (at most a delight to use, at least not frustrating)

guiding principles

  • Pragmatic solutions using “boring” techniques
    • Professional, maintainable solutions without unnecessary complexity
    • Code that is easy to understand and maintain over clever solutions
    • Proven, stable patterns over bleeding-edge features
  • Long-term maintainability and reliability

DW DX/workflow goals … want to be

  • easy to learn (to help teams get up to speed quickly)
  • efficient (to enable tasks to be completed as quickly as possible)
  • consistent (to prevent teams from wasting time relearning how to do their work)
  • transparent (to allow bugs to be diagnosed and solved easily)
  • resilient (to ensure what works today also works next year)
  • perfectly suited for quick prototyping - able to produce usable functionality quickly without the fear of it breaking unexpectedly (reliable and fast to produce)

Dw goal - build a robust system boilerplate that’s easy to modify & maintain guiding principles / Design decisions - do the predictable obvious thing, nothing too clever (makes debugging & maintenance easier, onboarding new devs, etc) designed to be flexible enough to fit a variety of use cases and architectures, work with a variety of services (hosting providers, cdn, images, mailers, etc)

goal: easier (as easy as) installation/deployment than wordpress … esp want to be easier than laravel

Dw goal - make it just as easy to build a custom crud app as it is to configure a generic 3rd party cms to suit your needs if you’ve evaluated any cms, you’ve likely hit the frustration of the various configuration nightmares and learning new concepts and thought “i could just build something like this in the same amount of time as it would take to learn it)