darto_view

Template engine plugin for Darto — pluggable, Hono-style renderer registration via middleware.

Ships with a Mustache engine out of the box. Any engine can be added by implementing the TemplateEngine interface.

Install

dependencies:
  darto: ^1.0.0
  darto_view: ^1.0.0
  mustache_template: ^2.0.0
  path: ^1.9.0

Quick start

import 'package:darto/darto.dart';
import 'package:darto_view/darto_view.dart';

void main() {
  final app = Darto();

  // Register the engine once — all handlers can call c.render().
  app.use(viewEngine(MustacheEngine(viewsPath: 'views')));

  app.get('/', [], (c) => c.render('index', {
    'title': 'Home',
    'items': ['Routing', 'Middleware', 'Validation'],
  }));

  app.get('/about', [], (c) => c.render('about', {
    'title': 'About',
    'version': '1.0.0',
  }));

  app.listen(3000);
}

Place templates in the views/ directory with a .mustache extension.

views/index.mustache:

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <title>{{title}}</title>
</head>
<body>
  <h1>{{title}}</h1>
  <ul>
    {{#items}}<li>{{.}}</li>{{/items}}
  </ul>
</body>
</html>

viewEngine(engine) middleware

Registers engine as the view renderer for every handler downstream.
Internally it calls c.setRender(layout) so c.render(templateName, data) works transparently.

// Global — all routes
app.use(viewEngine(MustacheEngine(viewsPath: 'views')));

// Scoped — only routes under /admin
app.mount('/admin/*', viewEngine(MustacheEngine(viewsPath: 'views/admin')));

MustacheEngine

Parameter Type Default Description
viewsPath String 'views' Directory where .mustache files live

Compiled templates are cached in memory after the first render — no disk I/O on subsequent requests.

Custom engines

Implement TemplateEngine to plug in any template system:

import 'package:darto_view/darto_view.dart';

class JinjaEngine implements TemplateEngine {
  final String viewsPath;
  JinjaEngine({this.viewsPath = 'views'});

  @override
  Future<String> render(String template, Map<String, dynamic> data) async {
    // load file, render with your preferred package, return HTML string
    throw UnimplementedError();
  }
}

// Register like any other engine
app.use(viewEngine(JinjaEngine(viewsPath: 'views')));

Direct HTML (no template)

app.get('/ping', [], (c) => c.html('<h1>pong</h1>'));

API reference

Symbol Description
viewEngine(engine) Middleware — registers the engine on the context
TemplateEngine Abstract class — implement to bring your own engine
MustacheEngine({viewsPath}) Built-in Mustache engine with in-memory caching

See also



Support 💖

If you find Darto View useful, please consider supporting its development 🌟Buy Me a Coffee.🌟 Your support helps us improve the package and make it even better!


Libraries

darto_view