Newt User Manual

What is in the Newt toolbox?

• Newt, is a development tool. It’s primary task is as a code generator and secondary task is a app runner. As an app runner it is capabile of running Newt’s router and template engine and selected JSON data sources such as datasetd or PostgREST.
• Newt’s router is a web service that manages your requests and data pipelines as well as static file hosting

Newt YAML syntax (draft)

• Newt YAML Syntax

Tutorials and reference materials (drafts)

• Getting Started with Newt
  • Newt Overview
  • Configuring
  • Modeling Data
  • Checking your YAML
  • Generating code
• Generating your Newt App
  • Generated middleware
  • Validator Explained
  • Template Engine Explained
• Running your Newt App
  • Newt Router Explained

Presentations

• Newt Prototype 3, (covers third prototype, refining applications and template switch from mustache to handlebars)
• Newt Prototype 2, SoCal Code4Lib Meetup at USC, April 19, 2024 (covers second prototype)
• Original Newt Presentation, SoCal Code4Lib Meetup at UCLA, July 14, 2023 (covers first prototype)

Miscellanea

• prototype 3 ideas
• prototype 2 ideas
• use cases
• improving the type dsl
• Have more questions?
• Reference Material, links to prior art

Installation

• Installing Newt
• Installing Dataset and Datasetd

Migth be useful

• Installing PostgREST from source (developer notes)
• Installing Pandoc from source (developer notes, Pandoc is needed to compile Newt)

Reference

• Evolving Assumptions, a timeline of web related technological changes
• Structured Data Representations, a musing on how to handle complex data objects in HTML, CSS and JavaScript