Latest 7.3.2
License MIT
Platforms ios 4.3, osx 10.6
Dependencies JRSwizzle
Frameworks Foundation

GRMustache is a Mustache template engine written in Objective-C, for both MacOS Cocoa and iOS.

It ships with built-in goodies and extensibility hooks that let you avoid the strict minimalism of the genuine Mustache language when you need it.

April 22, 2015: GRMustache 7.3.2 is out. Release notes

Get release announcements and usage tips: follow @GRMustache on Twitter.

System requirements

GRMustache targets iOS down to version 4.3, MacOS down to 10.6 Snow Leopard (without garbage collection), and only depends on the Foundation framework.

Swift developers: You can use GRMustache from Swift, with a limitation: you can only render Objective-C objects. Instead, consider using GRMustache.swift, a pure Swift implementation of GRMustache.

How To

1. Setup your Xcode project

You have three options, from the simplest to the hairiest:

2. Start rendering templates

#import "GRMustache.h"


// Renders "Hello Arthur!"
NSString *rendering = [GRMustacheTemplate renderObject:@{ @"name": @"Arthur" } fromString:@"Hello {{name}}!" error:NULL];
// Renders the `Profile.mustache` resource of the main bundle
NSString *rendering = [GRMustacheTemplate renderObject:user fromResource:@"Profile" bundle:nil error:NULL];

Reuse templates in order to avoid parsing the same template several times:

GRMustacheTemplate *template = [GRMustacheTemplate templateFromResource:@"Profile" bundle:nil error:nil];
rendering = [template renderObject:arthur error:NULL];
rendering = [template renderObject:barbara error:NULL];
rendering = ...


If you don’t know Mustache, start here:


Released under the MIT License.

Other Nifty Libraries

Latest podspec

    "name": "GRMustache",
    "version": "7.3.2",
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    "summary": "Flexible and production-ready Mustache templates for MacOS Cocoa and iOS.",
    "homepage": "",
    "authors": {
        "Gwendal Rouu00e9": "[email protected]"
    "source": {
        "git": "",
        "tag": "v7.3.2"
    "source_files": "src/classes/**/*.{h,m}",
    "private_header_files": "src/classes/**/*_private.h",
    "platforms": {
        "ios": "4.3",
        "osx": "10.6"
    "requires_arc": false,
    "frameworks": "Foundation",
    "dependencies": {
        "JRSwizzle": [
            "~> 1.0"

Pin It on Pinterest

Share This