From a663c9b07299ddbe37b4efc9cfead2f6bc472c3d Mon Sep 17 00:00:00 2001
From: Mark Bates <mark@markbates.com>
Date: Thu, 5 Apr 2018 16:17:31 -0400
Subject: [PATCH 1/3] split out a few things from the generated action.App()
 implementation. Hopefully this will help with a bit more in-line
 documentation, as well, as showing a pattern for keeping that method tame
 when it starts getting big.

---
 .../newapp/templates/actions/app.go.tmpl      | 35 ++++++++++++++-----
 1 file changed, 26 insertions(+), 9 deletions(-)

diff --git a/generators/newapp/templates/actions/app.go.tmpl b/generators/newapp/templates/actions/app.go.tmpl
index d844e239a..f411dc09c 100644
--- a/generators/newapp/templates/actions/app.go.tmpl
+++ b/generators/newapp/templates/actions/app.go.tmpl
@@ -47,10 +47,7 @@ func App() *buffalo.App {
       SessionName: "_{{.opts.Name.File}}_session",
     })
     // Automatically redirect to SSL
-    app.Use(ssl.ForceSSL(secure.Options{
-      SSLRedirect:     ENV == "production",
-      SSLProxyHeaders: map[string]string{"X-Forwarded-Proto": "https"},
-    }))
+    app.Use(forceSSL())
 
     {{ if .opts.AsAPI -}}
     // Set the request content type to JSON
@@ -76,11 +73,7 @@ func App() *buffalo.App {
 
     {{ if .opts.AsWeb -}}
     // Setup and use translations:
-    var err error
-    if T, err = i18n.New(packr.NewBox("../locales"), "en-US"); err != nil {
-      app.Stop(err)
-    }
-    app.Use(T.Middleware())
+    app.Use(translations())
     {{ end }}
 
     app.GET("/", HomeHandler)
@@ -92,3 +85,27 @@ func App() *buffalo.App {
 
   return app
 }
+
+{{ if .opts.AsWeb -}}
+// translations will load locale files, set up the translator `actions.T`,
+// and will return a middleware to use to load the correct locale for each
+// request.
+// for more information: https://gobuffalo.io/en/docs/localization
+func translations() buffalo.MiddlewareFunc {
+  var err error
+  if T, err = i18n.New(packr.NewBox("../locales"), "en-US"); err != nil {
+    app.Stop(err)
+  }
+  return T.Middleware()
+}
+{{ end }}
+
+// forceSSL will return a middleware that will redirect an incoming request
+// if it is not HTTPS. "http://example.com" => "https://example.com".
+// for more information: https://github.com/unrolled/secure/
+func forceSSL() buffalo.MiddlewareFunc {
+  return ssl.ForceSSL(secure.Options{
+    SSLRedirect:     ENV == "production",
+    SSLProxyHeaders: map[string]string{"X-Forwarded-Proto": "https"},
+  })
+}

From 0f501616a9f8662d080e88c6478440de7b704ad3 Mon Sep 17 00:00:00 2001
From: Mark Bates <mark@markbates.com>
Date: Thu, 5 Apr 2018 16:21:02 -0400
Subject: [PATCH 2/3] updated to mention using a proxy

---
 generators/newapp/templates/actions/app.go.tmpl | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/generators/newapp/templates/actions/app.go.tmpl b/generators/newapp/templates/actions/app.go.tmpl
index f411dc09c..95dce5824 100644
--- a/generators/newapp/templates/actions/app.go.tmpl
+++ b/generators/newapp/templates/actions/app.go.tmpl
@@ -102,6 +102,8 @@ func translations() buffalo.MiddlewareFunc {
 
 // forceSSL will return a middleware that will redirect an incoming request
 // if it is not HTTPS. "http://example.com" => "https://example.com".
+// This middleware does **not** enable SSL. for your application. To do that
+// we recommend using a proxy: https://gobuffalo.io/en/docs/proxy
 // for more information: https://github.com/unrolled/secure/
 func forceSSL() buffalo.MiddlewareFunc {
   return ssl.ForceSSL(secure.Options{

From 9d3d196b444a79431effdbd3c4663bb2ee5109c1 Mon Sep 17 00:00:00 2001
From: Mark Bates <mark@markbates.com>
Date: Thu, 5 Apr 2018 16:31:01 -0400
Subject: [PATCH 3/3] added a little more documentation to the generated
 main.go

---
 generators/newapp/templates/main.go.tmpl | 26 +++++++++++++++++++++++-
 1 file changed, 25 insertions(+), 1 deletion(-)

diff --git a/generators/newapp/templates/main.go.tmpl b/generators/newapp/templates/main.go.tmpl
index e7b8f7e6c..7e35108d1 100644
--- a/generators/newapp/templates/main.go.tmpl
+++ b/generators/newapp/templates/main.go.tmpl
@@ -6,9 +6,33 @@ import (
   "{{ .opts.ActionsPkg }}"
 )
 
+// main is the starting point to your Buffalo application.
+// you can feel free and add to this `main` method, change
+// what it does, etc...
+// All we ask is that, at some point, you make sure to
+// call `app.Serve()`, unless you don't want to start your
+// application that is. :)
 func main() {
   app := actions.App()
   if err := app.Serve(); err != nil {
     log.Fatal(err)
   }
-}
\ No newline at end of file
+}
+
+/*
+# Notes about `main.go`
+
+## SSL Support
+
+We recommend placing your application behind a proxy, such as
+Apache or Nginx and letting them do the SSL heaving lifting
+for you. https://gobuffalo.io/en/docs/proxy
+
+## Buffalo Build
+
+When `buffalo build` is run to compile your binary this `main`
+function will be at the heart of that binary. It is expected
+that your `main` function will start your application using
+the `app.Serve()` method.
+
+*/