News: Announcements for PostGraphile v 4.5 and Graphile Starter (grap…

…hile#182)

src/components/Layout/index.scss

@@ -903,6 +903,16 @@ h6 code {
   min-height: 240px;
 }
 
+.postgraphile-v4-4-contributions,
+.postgraphile-v4-5-explain,
+.starter-lightbulb {
+  background-size: contain;
+  background-repeat: no-repeat;
+  background-position: 50% 20%;
+  min-height: 140px;
+  max-height: 200px;
+}
+
 .postgraphile-graphs-average-latency {
   background-image: url("../../../static/images/v4-average-latency.png");
 }
@@ -918,7 +928,15 @@ h6 code {
 .postgraphile-graphs-memory-usage {
   background-image: url("../../../static/images/v4-memory-usage.png");
 }
-
+.postgraphile-v4-4-contributions {
+  background-image: url("../../../static/images/undraw_developer_activity.png");
+}
+.postgraphile-v4-5-explain {
+  background-image: url("../../../static/images/v4-5-explain.png");
+}
+.starter-lightbulb {
+  background-image: url("../../../static/images/undraw/lightbulb.png");
+}
 .postgraphile-logo-bg {
   background-image: url("../../../logos/postgraphile.optimized.svg");
   background-size: contain;

src/data/nav.json

@@ -12,6 +12,16 @@
       }
     ],
     "pages": [
+      {
+        "to": "/news/graphile-starter/",
+        "title": "Graphile Starter is here",
+        "sectionId": "main"
+      },
+      {
+        "to": "/news/postgraphile-version-4-5/",
+        "title": "Version 4.5 - Explain feature",
+        "sectionId": "main"
+      },
       {
         "to": "/news/postgraphile-version-4-4/",
         "title": "Version 4.4 - Real-time",

src/pages/news/graphile-starter.md

@@ -0,0 +1,42 @@
+---
+layout: page
+path: /news/graphile-starter/
+title: Graphile Starter is here!
+noToc: true
+---
+
+_Announced 2019-12-03_
+
+<p class='intro'>
+The team behind Graphile are excited to release Graphile Starter - an opinionated quick-start project for full-stack application development in React, Node.js, GraphQL and PostgreSQL. It includes the foundations of a modern web application, with a full user registration system, session management, optimised job queue, a significant amount of pre-configured tooling, tests and much more.
+</p>
+
+Graphile Starter is designed for client projects, hack days, side hustles, SaaS projects, and many other uses we haven't even thought of yet. The boilerplate for a React, GraphQL and Postgres stack is already there, just add your idea and you're ready to go.
+
+
+<div class="tc starter-lightbulb">
+</div>
+
+Some of the things included with the starter, ready for you to take and extend:
+
+**Batteries included:** full user system and OAuth, AntD design framework, jest and Cypress end-to-end testing, security, email templating and transport, pre-configured linting and code formatting, deployment instructions, and more
+
+**Speedy development:** easy debugging, Graphile's idempotent migration system, job queue and server middleware ready to use, hot reloading; not to mention deep integration with VSCode: plugin recommendations, preconfigured settings, ESLint and Prettier integration and debugging profiles
+
+**Type safety:** pre-configured type checking, strongly typed throughout with TypeScript
+
+**Best practices:** React, GraphQL, PostGraphile, Node, jest and Cypress best practices
+
+Full instructions and technical detail can be found on GitHub:
+
+- [Graphile Starter - github.com/graphile/starter](https://github.com/graphile/starter)
+
+### Thank you Graphile Sponsors
+
+Graphile Starter has been a labour of love, and would not be possible without our sponsors. We have recently joined the GitHub sponsors program and that, alongside Patreon, has been invaluable in giving us paid time to work on open source projects. **Take Graphile Starter, go make some money, and then give back** to help support further development on both the Starter and the Graphile suite of tools.
+
+[Click here to find out more about why and how you should sponsor PostGraphile development.](/sponsor/)
+
+<div class="tc">
+<img alt="Thank you" src="/images/undraw/undraw_super_thank_you_small.png" />
+</div>

src/pages/news/index.md

@@ -20,7 +20,7 @@ title: News
 
 <br />
 <div class='flex'>
-<a class='button--solid-light' href='/news/postgraphile-version-4-4/'>Latest Announcement <span class='fas fa-fw fa-arrow-right' /></a>
+<a class='button--solid-light' href='/news/graphile-starter/'>Latest Announcement <span class='fas fa-fw fa-arrow-right'></a>
 </div>
 
 </div>
@@ -38,11 +38,63 @@ title: News
 <div class='text-center col-xs-12 col-md-9 col-lg-7'>
 <div class='hero-block'>
 
-## PostGraphile Version 4.4 released
+## Graphile Starter is here
+_2019-12-03_
 
-Version 4.4 is here, and among other things it adds real-time features including GraphQL subscriptions and live queries!
+Graphile Starter has been released today; a new opinionated quick-start project which is designed to be built upon. Take your project idea and rapidly prototype it without having to think about session management, job queues, user registration system, testing or a design framework - all of that is included for you!
 
-[Read more about the latest PostGraphile version here](/news/postgraphile-version-4-4/)
+[Read the Graphile Starter announcement](/news/graphile-starter/)
+
+</div>
+</div>
+<div class='text-center col-xs-12 col-md-3 col-lg-5 starter-lightbulb'>
+</div>
+</div>
+
+</div>
+</section>
+
+
+<!-- **************************************** -->
+
+<section>
+<div class='container'>
+
+<div class='row flex-wrap-reverse'>
+<div class='text-center col-xs-12 col-md-9 col-lg-7'>
+<div class='hero-block'>
+
+## PostGraphile 4.5 - explain feature
+_2019-11-24_
+
+Version 4.5 is here, and with it comes an enhanced Graph*i*QL with a query explain feature. 
+
+[Read more about the latest PostGraphile version here](/news/postgraphile-version-4-5/)
+
+</div>
+</div>
+<div class='text-center col-xs-12 col-md-3 col-lg-5 postgraphile-v4-5-explain'>
+</div>
+</div>
+
+</div>
+</section>
+
+<!-- **************************************** -->
+
+<section>
+<div class='container'>
+
+<div class='row flex-wrap-reverse'>
+<div class='text-center col-xs-12 col-md-9 col-lg-7'>
+<div class='hero-block'>
+
+## PostGraphile 4.4 - real time features
+_2019-05-03_
+
+Version 4.4 has been released, and among other things it adds real-time features including GraphQL subscriptions and live queries!
+
+[Read more about the real time features in PostGraphile 4.4 here](/news/postgraphile-version-4-4/)
 
 </div>
 </div>
@@ -61,14 +113,17 @@ Version 4.4 is here, and among other things it adds real-time features including
 <div class='text-center col-xs-12 col-md-9 col-lg-7'>
 <div class='hero-block'>
 
-## PostGraphile Version 4.1 - better webpackability!
+## PostGraphile 4.1 - better webpackability!
+_2018-12-06_
 
 Building upon the huge performance gains found in Version 4, the release of Version 4.1 has a huge improvement to startup performance in serverless environments. This update also brings a large number of enhancements including much broader PostgreSQL function support, an enhanced GraphiQL interface, and a lot more helpers for writing plugins.
 
 [Read more about PostGraphile Version 4.1 here](/news/postgraphile-version-4-1/)
 
 </div>
 </div>
+<div class='text-center col-xs-12 col-md-3 col-lg-5 postgraphile-v4-4-contributions'>
+</div>
 </div>
 
 </div>
@@ -84,6 +139,7 @@ Building upon the huge performance gains found in Version 4, the release of Vers
 <div class='hero-block'>
 
 ## PostGraphile Version 4 is here
+_2018-10-02_
 
 Version 4 has launched! More performant, more extensible and more customisable than ever before. Easily extend PostGraphile's functionality with plugins developed and shared by the community.
 

src/pages/news/postgraphile-version-4-1.md

@@ -2,12 +2,13 @@
 layout: page
 path: /news/postgraphile-version-4-1/
 title: PostGraphile Releases Version 4.1 - Better Webpackability!
+noToc: true
 ---
 
-_Announced 2018-12-06_
-
 ### The original GraphQL API for PostgreSQL: now with improved Lambda support
 
+_Announced 2018-12-06_
+
 Building upon the huge performance gains found in Version 4, Benjie Gillam is pleased to announce the release of Version 4.1 of PostGraphile, now with a huge improvement to startup performance in serverless environments. This update also brings a large number of enhancements including much broader PostgreSQL function support, an enhanced GraphiQL interface, and a lot more helpers for writing plugins.
 
 [See the entire release notes on GitHub](https://github.com/graphile/postgraphile/releases/tag/v4.1.0).

src/pages/news/postgraphile-version-4-4.md

@@ -2,6 +2,7 @@
 layout: page
 path: /news/postgraphile-version-4-4/
 title: PostGraphile Releases Version 4.4 - Real-time!
+noToc: true
 ---
 
 _Announced 2019-05-03_
@@ -67,7 +68,7 @@ Huge thanks to the 70 individuals and companies already sponsoring PostGraphile!
 [Click here to find out more about why and how you should sponsor PostGraphile development.](/sponsor/)
 
 <div class="tc">
-<img alt="Real-time subscriptions" src="/images/thanks.png" />
+<img alt="Thank you" src="/images/thanks.png" />
 </div>
 
 ### Full release notes

src/pages/news/postgraphile-version-4-5.md

@@ -0,0 +1,51 @@
+---
+layout: page
+path: /news/postgraphile-version-4-5/
+title: PostGraphile Releases Version 4.5
+noToc: true
+---
+
+_Announced 2019-11-24_
+
+<p class='intro'>
+Graphile is pleased to announce the release of PostGraphile version 4.5.0, an upgrade recommended for all PostGraphile users.
+</p>
+<strong>🚨Beware:</strong> previously the CLI would ignore arguments it didn't understand, now it exits stating the arguments it wasn't expecting. If you were relying on this old behaviour, you will need to update your code to pass valid arguments.
+
+### New Feature: Explain in Graph*i*QL
+
+The headline feature in 4.5 is the addition of the new Explain feature in Graph*i*QL, visible by using the `--allow-explain` flag. In Graph*i*QL you'll see a new section in your return statement, plus new panel on the right which will show executed query in a readable format.
+
+<div class="tc">
+<img alt="Demo of the new GraphiQL Explain feature in PostGraphile" src="/images/graphiqlexplainbutton.png" />
+</div>
+
+### Smart Tags
+
+No longer do you need to put `COMMENT` commands in the database ("smart comments") to customise your schema, you can now use a tags file to gather these "smart tags" into one, version controlled, easy-to-diff place. Smart comments and smart tags can be used in unison, and both will be supported going forward so you can pick whichever works best for your team.
+
+### Big contributions from the Graphile community
+
+Thanks to everyone in the Graphile community who has contributed to this release; it's been a good release for community involvement as you can see in the [release notes](https://github.com/graphile/postgraphile/releases/tag/v4.5.0). Contributions from the community include improvements to QueryBuilder, better JWT support and bug fixes for types.
+
+<div class="tc">
+<img alt="Thank you" src="/images/thanks.png" />
+</div>
+
+### Thank you for your sponsorship
+
+By significantly reducing the amount of work needed to achieve business goals, PostGraphile results in huge savings for users. If your organization contributes some of these savings back then everyone can benefit from more frequent releases with better performance, better compatibility, better documentation, easier customization, and more features — leading to even greater savings or profits for your organization.
+
+We now have 84 sponsors across GitHub and Patreon and that means we're funded to spend an average of nearly 2 days per week on Open Source; this is brilliant!
+
+[Click here to find out more about why and how you should sponsor PostGraphile development.](/sponsor/)
+
+### Full release notes
+
+Full detailed technical release notes can be found on GitHub:
+
+- [v4.5.0 release notes](https://github.com/graphile/postgraphile/releases/tag/v4.5.0)
+- [v4.4.4 release notes](https://github.com/graphile/postgraphile/releases/tag/v4.4.4)
+- [v4.4.3 release notes](https://github.com/graphile/postgraphile/releases/tag/v4.4.3)
+- [v4.4.2 release notes](https://github.com/graphile/postgraphile/releases/tag/v4.4.2)
+- [v4.4.1 release notes](https://github.com/graphile/postgraphile/releases/tag/v4.4.1)

src/pages/news/postgraphile-version-4.md

@@ -2,6 +2,7 @@
 layout: page
 path: /news/postgraphile-version-4/
 title: PostGraphile Launches Version 4
+noToc: true
 ---
 
 _Announced 2018-10-02_

src/templates/page.js

@@ -140,7 +140,7 @@ class Page extends React.Component {
           html: rawHTML,
           tableOfContents: rawTableOfContents,
           timeToRead,
-          frontmatter: { title, fullTitle, showExamples },
+          frontmatter: { title, fullTitle, showExamples, noToc },
         },
         nav,
         examples,
@@ -149,7 +149,9 @@ class Page extends React.Component {
       history,
     } = this.props;
     const tableOfContents =
-      timeToRead > 1 ? processTableOfContents(rawTableOfContents) : null;
+      !noToc && timeToRead > 1
+        ? processTableOfContents(rawTableOfContents)
+        : null;
     const html = processHTML(rawHTML);
     const [, navSection] = location.pathname.split("/");
     const thisNavEdge = nav.edges.find(
@@ -340,6 +342,7 @@ export const pageQuery = graphql`
         title
         fullTitle
         showExamples
+        noToc
       }
     }
     nav: allNavJson {