dark-mental-model.md

The Parts of Dark

• core: language, editor, hosting, runtime, infra

  • the Dark language the definition, interpreter, standard library
  • the editor (what you're looking at right now - where you build Dark stuff)
  • the infrastructure, runtime, and hosting the runtime, hosting, connections, scaling

• handlers: http handlers, REPLs, refactors, migrations, etc.

  these have Dark code

  • http handlers public endpoints in the internet, so you can build backends
  • REPLs encode core business workflows and write one-off scripts
  • crons for scheduled background jobs
  • workers for async event-processing
  • future: websockets
  • future: refactors
  • future: tests

• data: data stores, static assets, files, telemetry, secrets

  • data stores so you can store your data in Dark itself
  • static assets hosting (and file hosting, eventually)
  • usage data logs, analytics, error reports, trace data, http and worker 404s
  • secrets management for storing API keys

• ecosystem: community, collaboration tools, packages

  • package management system and ecosystem for sharing code templates or libraries, refactorings, DB access, httpclient bindings, editor themes, etc.
    • across your personal canvases, across your private organization, or as a package usable by other Dark developers, either as open source or in a commercial marketplace