Package selection guidance compiled from public package information, community data, and project usage.
Jinja is a Dart implementation of the Jinja2 template engine, enabling dynamic content generation with variables, expressions, control structures, and template inheritance. It supports server-side rendering and integrates well with web frameworks. Designed for use in backend services and web applications, it allows developers to separate logic from presentation using powerful templating features. The package runs across all major platforms, including mobile, web, and desktop.
Use cases
Server-side rendering
Dynamic HTML generation
Template-based content creation
Web application layouts
API-driven templates
Multi-platform templating
Key features
Variable and expression support
Control structures (if, for)
Template inheritance
Cross-platform compatibility
Lightweight and fast
Easy integration with Dart apps
Suitable for
Backend developers
Full-stack web developers
Template-driven applications
Server-rendered web apps
Dart-based web frameworks
Considerations
Not intended for client-side rendering
Limited documentation
Requires understanding of Jinja2 syntax
Best suited for server environments
No built-in security filters
May need additional validation for user input
Original README
Original README snapshot from the linked source repository. Visit the repository for the latest content.
jinja
Jinja (3.x) server-side template engine port for Dart 3.
Variables, expressions, control structures and template inheritance.
Documentation
It is mostly similar to Jinja templates documentation, differences provided below.
work in progress.
Differences with Python version
Auto-escaping and related statements, filters and tests have been removed due to the impossibility of extending String.
Use the escape filter manually or escape values before passing them to the template.
The default filter compares values with null.
The defined and undefined tests compare values with null.
The map filter also compares values with null.
Use attribute and item filters for object.attribute and object[item] expressions.
If Environment({getAttribute}) is not passed, the getItem method will be used.
This allows you to use {{ map.key }} as an expression equivalent to {{ map['key'] }}.
String slices and negative indexes are not supported (list slicing [start:stop] with non-negative integers is supported).
Macro arguments without default values are required.
No FilterArgumentError error class.
No *args and **kwargs arguments.
No Template module.
work in progress
Dynamically invoked members (can increase the size of the JS output)
[], +, -, *, /, ~/, % operators
object.length getter
object.call getter
Function.apply(function, ...)
Example
import'package:jinja/jinja.dart';
// ...var environment = Environment(blockStart: '...', blockEnd: '...');
var template = environment.fromString('...source...');
print(template.render({'key': value}));
// or write directly to StringSink (IOSink, HttpResponse, ...)
template.renderTo(stringSink, {'key': value});
Contributions are welcome! Please open an issue or pull request on GitHub.
Look at the ToDo list and comments in the code for ideas on what to work on.
There are no strict rules, but please try to follow the existing code style.
As non-native English speaker and learner, I will be grateful for any
corrections in the documentation and code comments.
Support
Post issues and feature requests on the GitHub issue tracker.