ponzu-cms /ponzu

Headless CMS with automatic JSON API. Featuring auto-HTTPS from Let's Encrypt, HTTP/2 Server Push, and flexible server framework written in Go.

★ 5,761⑂ 383👁 123⑃ 174● 194▤ 16
GoBSD-3-ClauseCreated 2016-09-17docs.ponzu-cms.org
Download: Snap, editable slug and API response hooksSnap,-0.11.0 ↓0.11.02019-09-30
+0
Daily
5,761
stars
383
forks
123
watchers
174
prs
194
issues
16
releases

README

[!WARNING] 
 !  
 This project is currently abandoned, if you're looking for an open source HTTP Server with built in SSL/TLS support, feel free to try out Caddy Server.


	
		
			
			
			
		
	
	
	a  project


 [!NOTE] 
 !  
 If you're interested in regularly contributing to Ponzu CMS (with monetary compensation included) - feel free to reach out to us at [email protected]  
  
----

 Ponzu






 Watch the video introduction

Ponzu is a powerful and efficient open-source HTTP server framework and CMS. It 
provides automatic, free, and secure HTTP/2 over TLS (certificates obtained via 
Let's Encrypt), a useful CMS and scaffolding to 
generate content editors, and a fast HTTP API on which to build modern applications.

Ponzu is released under the BSD-3-Clause license (see LICENSE).
(c) Boss Sauce Creative, LLC

 Why?
With the rise in popularity of web/mobile apps connected to JSON HTTP APIs, better 
tools to support the development of content servers and management systems are necessary. 
Ponzu fills the void where you want to reach for Wordpress to get a great CMS, or Rails for
rapid development, but need a fast JSON response in a high-concurrency environment. 

Because you want to turn this:  
bash
$ ponzu gen content song title:"string" artist:"string" rating:"int" opinion:"string":richtext spotify_url:"string"


Into this: 

!Generated content/song.go


What's inside  
- Automatic & Free SSL/TLS1
- HTTP/2 and Server Push
- Rapid development with CLI-controlled code generators
- User-friendly, extensible CMS and administration dashboard
- Simple deployment - single binary + assets, embedded DB (BoltDB)
- Fast, helpful framework while maintaining control

1 TLS:
- Development: self-signed certificates auto-generated
- Production: auto-renewing certificates fetched from Let's Encrypt

↩

 Documentation
For more detailed documentation, check out the docs

 Installation


$ go get -u github.com/ponzu-cms/ponzu/...


 Requirements
Go 1.8+

Since HTTP/2 Server Push is used, Go 1.8+ is required. However, it is not 
required of clients connecting to a Ponzu server to make HTTP/2 requests. 

 Usage

bash
$ ponzu command [flags] 


 Commands

 new

Creates a project directory of the name supplied as a parameter immediately
following the 'new' option in the $GOPATH/src directory. Note: 'new' depends on 
the program 'git' and possibly a network connection. If there is no local 
repository to clone from at the local machine's $GOPATH, 'new' will attempt to 
clone the 'github.com/ponzu-cms/ponzu' package from over the network.

Example:
bash
$ ponzu new github.com/nilslice/proj
 New ponzu project created at $GOPATH/src/github.com/nilslice/proj


Errors will be reported, but successful commands return nothing.

---

 generate, gen, g

Generate boilerplate code for various Ponzu components, such as content.

Example:
bash
            generator      struct fields and built-in types...
             |              |
             v              v    
$ ponzu gen

Top issues

Latest release

Snap, editable slug and API response hooks v0.11.0 2019-09-30
This release includes new features.

1) Snap support. Install Ponzu CMS as a snap. See 313 & 307. 
Thanks @igorljubuncic

2) Editable slug. Ponzu users can now maintain the slug as part of their item maintenance. See 309. 
Thanks @junnotantra

3) BeforeAPIResponse and AfterAPIResponse hooks added offering opportunities to modify API response. See 305

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON