v0.17.1-canary.1

(ignore)

.all-contributorsrc

@@ -0,0 +1,801 @@
+{
+  "projectName": "blitz",
+  "projectOwner": "blitz-js",
+  "repoType": "github",
+  "repoHost": "https://github.com",
+  "files": [
+    "README.md"
+  ],
+  "badgeTemplate": "<a aria-label=\"All Contributors\" href=\"#contributors-\"><img alt=\"\" src=\"https://img.shields.io/badge/all_contributors-<%= contributors.length %>-17BB8A.svg?style=for-the-badge&labelColor=000000\"></a>",
+  "imageSize": 100,
+  "commit": true,
+  "commitConvention": "none",
+  "contributors": [
+    {
+      "login": "flybayer",
+      "name": "Brandon Bayer",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/8813276?v=4",
+      "profile": "https://twitter.com/flybayer",
+      "contributions": [
+        "code",
+        "content",
+        "ideas",
+        "review"
+      ]
+    },
+    {
+      "login": "ryardley",
+      "name": "Rudi Yardley",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/1256409?v=4",
+      "profile": "https://medium.com/@ryardley",
+      "contributions": [
+        "code",
+        "ideas",
+        "review",
+        "test"
+      ]
+    },
+    {
+      "login": "merelinguist",
+      "name": "Dylan Brookes",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/24858006?v=4",
+      "profile": "https://merelinguist.me",
+      "contributions": [
+        "code",
+        "ideas",
+        "review",
+        "test",
+        "doc"
+      ]
+    },
+    {
+      "login": "aem",
+      "name": "Adam Markon",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/1909883?v=4",
+      "profile": "https://github.com/aem",
+      "contributions": [
+        "code",
+        "ideas",
+        "review",
+        "test",
+        "maintenance"
+      ]
+    },
+    {
+      "login": "coreybrown89",
+      "name": "Corey Brown",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/12791148?v=4",
+      "profile": "https://corey-brown.com",
+      "contributions": [
+        "code",
+        "review",
+        "maintenance"
+      ]
+    },
+    {
+      "login": "LoriKarikari",
+      "name": "Lori Karikari",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/7902980?v=4",
+      "profile": "https://github.com/LoriKarikari",
+      "contributions": [
+        "code",
+        "review",
+        "maintenance",
+        "doc"
+      ]
+    },
+    {
+      "login": "eliasjohansson",
+      "name": "Elias Johansson",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/22719177?v=4",
+      "profile": "https://twitter.com/GeggsElias",
+      "contributions": [
+        "code",
+        "review",
+        "maintenance"
+      ]
+    },
+    {
+      "login": "medelman17",
+      "name": "Michael Edelman ",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/14793389?v=4",
+      "profile": "https://fabulas.io",
+      "contributions": [
+        "infra",
+        "code"
+      ]
+    },
+    {
+      "login": "toddgeist",
+      "name": "Todd Geist",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/316792?v=4",
+      "profile": "http://www.geistinteractive.com",
+      "contributions": [
+        "financial"
+      ]
+    },
+    {
+      "login": "robdrosenberg",
+      "name": "Robert Rosenberg",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/20813991?v=4",
+      "profile": "http://robdrosenberg.com",
+      "contributions": [
+        "code",
+        "maintenance",
+        "doc"
+      ]
+    },
+    {
+      "login": "quirk0o",
+      "name": "Beata Obrok",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/5123725?v=4",
+      "profile": "https://github.com/quirk0o",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "tsawan",
+      "name": "Tahir Awan",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/3263082?v=4",
+      "profile": "https://github.com/tsawan",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "camilo86",
+      "name": "Camilo Gonzalez",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/2454632?v=4",
+      "profile": "https://raluce.com",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "dkempner",
+      "name": "Daniel Kempner",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/2532112?v=4",
+      "profile": "http://da.nielkempner.com",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "gielcobben",
+      "name": "Giel",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/2663212?v=4",
+      "profile": "http://gielcobben.com",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "MrLeebo",
+      "name": "Jeremy Liberman",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/2754163?v=4",
+      "profile": "http://jeremyliberman.com/",
+      "contributions": [
+        "code",
+        "maintenance",
+        "test"
+      ]
+    },
+    {
+      "login": "jimthedev",
+      "name": "Jim Cummins",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/108938?v=4",
+      "profile": "https://jimthedev.com",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "name": "Kristina Matuška",
+      "avatar_url": "https://media-exp1.licdn.com/dms/image/C5603AQHVPAjV21gw9g/profile-displayphoto-shrink_200_200/0?e=1591228800&v=beta&t=0MlbmiYhNvGv1xjLD_fOhOFjVDZ7ltNwfGNeJ4DHedQ",
+      "profile": "http://kristinamatuska.com/",
+      "contributions": [
+        "design"
+      ]
+    },
+    {
+      "login": "jasonblalock",
+      "name": "Jason Blalock",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/5899929?v=4",
+      "profile": "https://github.com/jasonblalock",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "aej11a",
+      "name": "aej11a",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/10066422?v=4",
+      "profile": "https://github.com/aej11a",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "marcoseoane",
+      "name": "marcoseoane",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/28088807?v=4",
+      "profile": "https://github.com/marcoseoane",
+      "contributions": [
+        "ideas"
+      ]
+    },
+    {
+      "login": "rishabhpoddar",
+      "name": "Rishabh Poddar",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/2976287?v=4",
+      "profile": "https://github.com/rishabhpoddar",
+      "contributions": [
+        "ideas"
+      ]
+    },
+    {
+      "login": "lorenzorapetti",
+      "name": "Lorenzo Rapetti",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/2632174?v=4",
+      "profile": "https://github.com/lorenzorapetti",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "wKovacs64",
+      "name": "Justin Hall",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/1288694?v=4",
+      "profile": "https://github.com/wKovacs64",
+      "contributions": [
+        "code",
+        "doc"
+      ]
+    },
+    {
+      "login": "sijad",
+      "name": "Sajjad Hashemian",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/7693001?v=4",
+      "profile": "https://github.com/sijad",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "ETLopes",
+      "name": "Eduardo Lopes",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/34959471?v=4",
+      "profile": "https://github.com/ETLopes",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "mattleff",
+      "name": "Matthew Leffler",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/120155?v=4",
+      "profile": "https://github.com/mattleff",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "hew",
+      "name": "Matt",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/3103241?v=4",
+      "profile": "https://hew.tools",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "sonnypgs",
+      "name": "Sonny",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/1431300?v=4",
+      "profile": "https://github.com/sonnypgs",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "Zeko369",
+      "name": "Fran Zekan",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/3064377?v=4",
+      "profile": "https://github.com/Zeko369",
+      "contributions": [
+        "code",
+        "doc"
+      ]
+    },
+    {
+      "login": "janbaykara",
+      "name": "Jan Baykara",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/237556?v=4",
+      "profile": "http://twitter.com/JanBaykara",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "mikeattara",
+      "name": "Mike Perry Y Attara",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/31483629?v=4",
+      "profile": "https://mikeattara.com",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "DevanB",
+      "name": "Devan",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/354652?v=4",
+      "profile": "https://devanthe.dev",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "jclancy93",
+      "name": "Jack Clancy",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/7850202?v=4",
+      "profile": "https://github.com/jclancy93",
+      "contributions": [
+        "code",
+        "maintenance"
+      ]
+    },
+    {
+      "login": "ntgussoni",
+      "name": "Nicolas Torres",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/10161067?v=4",
+      "profile": "https://github.com/ntgussoni",
+      "contributions": [
+        "test",
+        "code"
+      ]
+    },
+    {
+      "login": "skn0tt",
+      "name": "Simon Knott",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/14912729?v=4",
+      "profile": "http://simonknott.de",
+      "contributions": [
+        "code",
+        "test",
+        "maintenance"
+      ]
+    },
+    {
+      "login": "kandros",
+      "name": "Jaga Santagostino",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/4562878?v=4",
+      "profile": "http://jagascript.com",
+      "contributions": [
+        "code",
+        "doc",
+        "maintenance"
+      ]
+    },
+    {
+      "login": "jportela",
+      "name": "João Portela",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/1010018?v=4",
+      "profile": "http://www.joaoportela.com",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "dajinchu",
+      "name": "Da-Jin Chu",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/7122182?v=4",
+      "profile": "http://dajin.dev",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "Shinyaigeek",
+      "name": "Shinobu Hayashi",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/42742053?v=4",
+      "profile": "https://shinyaigeek.dev/",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "karankiri",
+      "name": "Karan Kiri",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/19989161?v=4",
+      "profile": "http://karankiri.com",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "fullmetalengineer",
+      "name": "Alan Long",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/5294903?v=4",
+      "profile": "https://github.com/fullmetalengineer",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "developerfred",
+      "name": "codingsh",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/57037080?v=4",
+      "profile": "http://codingsh.xyz",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "peaonunes",
+      "name": "Rafael Nunes",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/3356720?v=4",
+      "profile": "http://twitter.com/peaonunes",
+      "contributions": [
+        "review",
+        "code"
+      ]
+    },
+    {
+      "login": "0ww",
+      "name": "Simon Debbarma",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/31207418?v=4",
+      "profile": "https://simonpeterdebbarma.com",
+      "contributions": [
+        "design",
+        "maintenance",
+        "doc"
+      ]
+    },
+    {
+      "login": "0xflotus",
+      "name": "0xflotus",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/26602940?v=4",
+      "profile": "https://github.com/0xflotus",
+      "contributions": [
+        "code",
+        "doc"
+      ]
+    },
+    {
+      "login": "tmns",
+      "name": "tmns",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/35785003?v=4",
+      "profile": "https://dev.to/tmns",
+      "contributions": [
+        "code",
+        "doc"
+      ]
+    },
+    {
+      "login": "harris1717",
+      "name": "Jru Harris",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/8636691?v=4",
+      "profile": "http://jruharris.com",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "ivandevp",
+      "name": "Ivan Medina",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/9284690?v=4",
+      "profile": "https://twitter.com/ivandevp",
+      "contributions": [
+        "code",
+        "maintenance"
+      ]
+    },
+    {
+      "login": "dwightwatson",
+      "name": "Dwight Watson",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/1100408?v=4",
+      "profile": "https://www.dwightwatson.com",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "is2ei",
+      "name": "Horie Issei",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/3948353?v=4",
+      "profile": "http://is2ei.com/",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "lednhatkhanh",
+      "name": "Nhat Khanh",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/9303093?v=4",
+      "profile": "https://twitter.com/lednhatkhanh",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "abuuzayr",
+      "name": "Abu Uzayr",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/19371989?v=4",
+      "profile": "https://builtforfifty.com",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "nabi009",
+      "name": "Nabiullah elham",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/3170831?v=4",
+      "profile": "https://github.com/nabi009",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "lachlanjc",
+      "name": "Lachlan Campbell",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/5074763?v=4",
+      "profile": "https://lachlanjc.com",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "enzoferey",
+      "name": "Enzo Ferey",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/10673347?v=4",
+      "profile": "http://enzoferey.com",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "pgrimaud",
+      "name": "Pierre Grimaud",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/1866496?v=4",
+      "profile": "https://github.com/pgrimaud",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "jletey",
+      "name": "John Letey",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/62398724?v=4",
+      "profile": "https://github.com/jletey",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "pixelmord",
+      "name": "Andreas Adam",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/224168?v=4",
+      "profile": "https://pixelmord.github.io",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "kevotovar",
+      "name": "Kevin Tovar",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/15717067?v=4",
+      "profile": "https://kevo.dev",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "anteprimorac",
+      "name": "Ante Primorac",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/972083?v=4",
+      "profile": "http://anteprimorac.com.hr",
+      "contributions": [
+        "code",
+        "doc"
+      ]
+    },
+    {
+      "login": "MykalMachon",
+      "name": "Mykal Machon",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/7844994?v=4",
+      "profile": "http://mykalmachon.dev",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "jamiedavenport",
+      "name": "Jamie Davenport",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/1329874?v=4",
+      "profile": "https://jamiedavenport.dev",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "ganeshmani",
+      "name": "GaneshMani",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/17050715?v=4",
+      "profile": "https://cloudnweb.dev/",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "reymon359",
+      "name": "reymon359",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/31936665?v=4",
+      "profile": "http://ramonmorcillo.com",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "gvasquez11",
+      "name": "gvasquez11",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/36422346?v=4",
+      "profile": "https://www.linkedin.com/in/gregory-vasquez-96413b184/",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "josemiguelo",
+      "name": " José Miguel Ochoa",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/15330034?v=4",
+      "profile": "https://github.com/josemiguelo",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "osirvent",
+      "name": "Oscar Sirvent",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/5927133?v=4",
+      "profile": "https://github.com/osirvent",
+      "contributions": [
+        "code",
+        "doc"
+      ]
+    },
+    {
+      "login": "donni106",
+      "name": "Daniel Molnar",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/1942953?v=4",
+      "profile": "https://github.com/donni106",
+      "contributions": [
+        "doc",
+        "code"
+      ]
+    },
+    {
+      "login": "exclipy",
+      "name": "Kevin Wu Won",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/508799?v=4",
+      "profile": "https://github.com/exclipy",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "tehnuge",
+      "name": "John Duong",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/1928236?v=4",
+      "profile": "https://github.com/tehnuge",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "fnoah",
+      "name": "Noah Fleischmann",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/23707137?v=4",
+      "profile": "https://noahfleischmann.com",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "toshi1127",
+      "name": "Matsumoto Toshi",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/32378535?v=4",
+      "profile": "https://github.com/toshi1127",
+      "contributions": [
+        "code",
+        "doc"
+      ]
+    },
+    {
+      "login": "simonedelmann",
+      "name": "Simon Edelmann",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/2821076?v=4",
+      "profile": "https://github.com/simonedelmann",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "shaunchurch",
+      "name": "Shaun Church",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/571764?v=4",
+      "profile": "https://shaun.church",
+      "contributions": [
+        "doc",
+        "code"
+      ]
+    },
+    {
+      "login": "styfle",
+      "name": "Steven",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/229881?v=4",
+      "profile": "https://styfle.dev",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "SigurdMW",
+      "name": "Sigurd Moland Wahl",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/6359003?v=4",
+      "profile": "https://github.com/SigurdMW",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "sbardian",
+      "name": "Brian Andrews",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/6384100?v=4",
+      "profile": "https://brianandrews.dev/",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "garrisons",
+      "name": "Garrison Snelling",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/5100597?v=4",
+      "profile": "http://garrisonsnelling.com",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "tylangesmith",
+      "name": "Ty Lange-Smith",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/22609577?v=4",
+      "profile": "https://github.com/tylangesmith",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "rubenmoya",
+      "name": "Rubén Moya",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/905225?v=4",
+      "profile": "https://rubenmoya.dev",
+      "contributions": [
+        "code",
+        "test"
+      ]
+    },
+    {
+      "login": "robertgrzonka",
+      "name": "robertgrzonka",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/35585466?v=4",
+      "profile": "https://github.com/robertgrzonka",
+      "contributions": [
+        "code",
+        "infra"
+      ]
+    }
+  ],
+  "contributorsPerLine": 7,
+  "skipCi": true
+}

.eslintrc.js

@@ -0,0 +1,39 @@
+module.exports = {
+  parser: "@typescript-eslint/parser",
+  parserOptions: {
+    ecmaVersion: 6,
+    sourceType: "module",
+    ecmaFeatures: {
+      jsx: true,
+    },
+    project: `./tsconfig.json`,
+  },
+  plugins: ["@typescript-eslint", "import", "unicorn"],
+  extends: ["react-app"],
+  rules: {
+    "react/react-in-jsx-scope": "off", // React is always in scope with Blitz
+    "jsx-a11y/anchor-is-valid": "off", //Doesn't play well with Blitz/Next <Link> usage
+    "import/first": "off",
+    "import/no-default-export": "error",
+    "require-await": "error",
+    "no-async-promise-executor": "error",
+    "unicorn/filename-case": [
+      "error",
+      {
+        case: "kebabCase",
+      },
+    ],
+    "@typescript-eslint/no-floating-promises": "error",
+  },
+  ignorePatterns: ["packages/cli/", "packages/generator/templates"],
+  overrides: [
+    {
+      files: ["examples/**", "packages/gui/**", "recipes/**"],
+      rules: {
+        "import/no-default-export": "off",
+        "unicorn/filename-case": "off",
+        "@typescript-eslint/no-floating-promises": "off",
+      },
+    },
+  ],
+}

.gitattributes

@@ -0,0 +1 @@
+* text=auto eol=lf

.github/CODEOWNERS

@@ -0,0 +1,10 @@
+# https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-code-owners
+
+* @flybayer
+*.md @merelinguist
+
+packages/server/**/* @ryardley
+packages/file-pipeline/**/* @ryardley
+packages/cli/**/* @aem
+packages/generator/**/* @aem
+packages/installer/**/* @aem

.github/FUNDING.yml

@@ -0,0 +1,4 @@
+github: blitz-js
+custom: ["https://paypal.me/thebayers"]
+open_collective: blitzjs
+patreon: flybayer

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,23 @@
+---
+name: Bug report
+about: Something is not working right. Or error messages are unclear.
+title: ''
+labels: ''
+assignees: ''
+---
+
+### What is the problem?
+
+### Steps to Reproduce
+
+1.
+
+### Versions
+
+```
+output of `blitz --version --verbose`
+```
+
+### Other
+
+Please include applicable logs and screenshots that show your problem.

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Question or Discussion
+    url: https://github.com/blitz-js/blitz/discussions/new
+    about: Ask questions and discuss with other community members

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,19 @@
+---
+name: Feature/change request
+about: Something new or better!
+title: ""
+labels: ""
+assignees: ""
+---
+
+### What do you want and why?
+
+The more information the better!
+
+### Possible implementation(s)
+
+How might we do this?
+
+### Additional context
+
+Add any other context or screenshots about the feature request here.

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,10 @@
+Closes: ??
+
+### What are the changes and their implications?
+
+### Checklist
+
+- [ ] Tests added for changes
+- [ ] PR submitted to [blitzjs.com](https://github.com/blitz-js/blitzjs.com) for any user facing changes
+
+<!-- IMPORTANT: Make sure to check the "Allow edits from maintainers" box below this window -->

.github/checkInstallTime.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+
+const fs = require("fs")
+const yarnOut = fs.readFileSync(0, {encoding: "utf8"})
+
+const [installTimeString] = /(?<=^Done in )\d+\.\d+(?=s\.$)/m.exec(yarnOut)
+const installTime = Number(installTimeString)
+
+console.log(`Install time: ${installTime}s`)
+
+if (installTime < 30) {
+  console.log("We're below 30 secs. That's awesome!")
+} else if (installTime < 50) {
+  console.log("We're below 50 secs. That's fine!")
+} else {
+  console.log("We're above 50 secs. That's not great!")
+  process.exit(1)
+}

.github/workflows/compressed.yml

@@ -0,0 +1,25 @@
+name: Compressed Size
+
+on:
+  pull_request:
+    branches: [master, canary]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v2
+      - name: Use Node and Yarn
+        uses: actions/setup-node@v1
+        with:
+          node-version: "12.x"
+      - name: Install dependencies
+        run: |
+          yarn && yarn build
+        env:
+          CI: true
+      - name: Count size
+        uses: preactjs/compressed-size-action@v2
+        with:
+          repo-token: "${{ secrets.GITHUB_TOKEN }}"

.github/workflows/main.yml

@@ -0,0 +1,127 @@
+name: Continuous Integration
+
+on:
+  push:
+    branches:
+      - master
+      - canary
+  pull_request:
+    branches:
+      - master
+      - canary
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Use Node.js
+        uses: actions/setup-node@v1
+        with:
+          node-version: "12.16.1"
+      - name: Get yarn cache directory path
+        id: yarn-cache-dir-path
+        run: echo "::set-output name=dir::$(yarn cache dir)"
+      - name: Cache node_modules
+        id: yarn-cache
+        uses: actions/cache@v2
+        with:
+          path: |
+            ${{ steps.yarn-cache-dir-path.outputs.dir }}
+            **/node_modules
+            /home/runner/.cache/Cypress
+            C:\Users\runneradmin\AppData\Local\Cypress\Cache
+          key: ${{ runner.os }}-yarn-v2-${{ hashFiles('yarn.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-yarn-v2-
+      - name: Install dependencies
+        run: yarn install --frozen-lockfile --silent
+        env:
+          CI: true
+      - name: yarn lint
+        run: yarn lint
+        env:
+          CI: true
+  build_and_test_pkgs:
+    name: Build & Test Packages
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v2
+      - name: Use Node.js
+        uses: actions/setup-node@v1
+        with:
+          node-version: "12.16.1"
+      - name: Get yarn cache directory path
+        id: yarn-cache-dir-path
+        run: echo "::set-output name=dir::$(yarn cache dir)"
+      - name: Cache node_modules
+        id: yarn-cache
+        uses: actions/cache@v2
+        with:
+          path: |
+            ${{ steps.yarn-cache-dir-path.outputs.dir }}
+            /home/runner/.cache/Cypress
+            C:\Users\runneradmin\AppData\Local\Cypress\Cache
+          key: ${{ runner.os }}-yarn-v2-${{ hashFiles('yarn.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-yarn-v2-
+      - name: Install dependencies
+        run: yarn install --frozen-lockfile --silent
+        env:
+          CI: true
+      - name: Setup kernel to increase watchers
+        if: matrix.os == 'ubuntu-latest'
+        run: echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p
+      - name: Build packages
+        run: yarn build
+        env:
+          CI: true
+      - name: Test Blitz Packages
+        run: yarn testonly:packages
+        env:
+          CI: true
+  build_and_test_examples:
+    name: Build & Test Examples
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v2
+      - name: Use Node.js
+        uses: actions/setup-node@v1
+        with:
+          node-version: "12.16.1"
+      - name: Get yarn cache directory path
+        id: yarn-cache-dir-path
+        run: echo "::set-output name=dir::$(yarn cache dir)"
+      - name: Cache node_modules
+        id: yarn-cache
+        uses: actions/cache@v2
+        with:
+          path: |
+            ${{ steps.yarn-cache-dir-path.outputs.dir }}
+            /home/runner/.cache/Cypress
+            C:\Users\runneradmin\AppData\Local\Cypress\Cache
+          key: ${{ runner.os }}-yarn-v2-${{ hashFiles('yarn.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-yarn-v2-
+      - name: Install dependencies
+        run: yarn install --frozen-lockfile --silent
+        env:
+          CI: true
+      - name: Setup kernel to increase watchers
+        if: matrix.os == 'ubuntu-latest'
+        run: echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p
+      - name: Build packages
+        run: yarn build
+        env:
+          CI: true
+      - name: Test examples
+        run: yarn testonly:examples
+        env:
+          CI: true

.gitignore

@@ -0,0 +1,24 @@
+.log
+.DS_Store
+.jest-*
+lib
+node_modules
+reports
+*.log
+.nyc_output
+**/coverage
+.yarn
+.yarnrc
+tsconfig.tsbuildinfo
+.blitz
+.next
+dist
+.now
+# local env files
+**/.envrc
+**/.env
+**/.env.local
+**/.env.development.local
+**/.env.test.local
+**/.env.production.local
+.blitz-*

.npmignore

@@ -0,0 +1,16 @@
+.DS_Store
+.prettierrc
+.nyc_output
+.travis.yml
+coverage
+coverage.lcov
+bench
+docs
+src
+examples
+babel.config.js
+test
+CONTRIBUTING.md
+CODE_OF_CONDUCT.md
+*.ts
+!*.d.ts

.npmrc

@@ -0,0 +1 @@
+save-exact=true

.prettierignore

@@ -0,0 +1,20 @@
+**/migrations/**
+.blitz
+.next
+.log
+.DS_Store
+.jest-*
+lib
+node_modules
+reports
+*.log
+**/.env*
+.nyc_output
+**/coverage
+.yarn
+.yarnrc
+tsconfig.tsbuildinfo
+dist
+bin
+packages/generator/templates/**
+.github/ISSUE_TEMPLATE/bug_report.md

CODE_OF_CONDUCT.md

@@ -0,0 +1,3 @@
+# The Blitz Community Code of Conduct
+
+[Read the Code of Conduct at Blitzjs.com](https://blitzjs.com/docs/code-of-conduct)

CONTRIBUTING.md

@@ -0,0 +1,3 @@
+# Contributing
+
+[Read the Contributing Guide at Blitzjs.com](https://blitzjs.com/docs/contributing)

GOVERNANCE.md

@@ -0,0 +1,11 @@
+# Blitz.js Governance
+
+_From Brandon Bayer (@flybayer), the creator:_
+
+Currently at this very early stage it's basically a [BDFL situation](https://opensource.guide/leadership-and-governance/#what-are-some-of-the-common-governance-structures-for-open-source-projects), with me having the final say in decisions.
+
+However we will move away from BDFL to something that looks more like Ember.js. It's extremely important to me (Brandon) that Blitz.js is a long-term, sustainable, and community-run project.
+
+I would love some mentorship from people with experience in large open-source projects on making this transition.
+
+Also, it's possible I will create one or more business around Blitz, perhaps similar to how Taylor Otwell has around Laravel, but Blitz itself will always remain a separate community-run project.

MAINTAINERS.md

@@ -0,0 +1,104 @@
+# ❤️ Blitz Maintainers
+
+Aside from the core team, there are two levels of maintainers, described below.
+
+## Becoming a Maintainer
+
+We always need more level 1 maintainers! The main requirement is that you can show empathy when communicating online. We'll train you as needed on the other specifics. **This is a great role if you have limited time, because you can spend just as much time as you have without any ongoing responsibilities (unlike level 2)**
+
+Level 2 maintainers have a much higher responsibility, so usually you will spend time as a level 1 maintainer before moving to level 2.
+
+Please DM a core team member (Brandon Bayer, Rudi Yardley, or Dylan Brookes) in Slack if you're interested in becoming an official maintainer!
+
+## Level 1 Maintainers
+
+Level 1 maintainers are critical for a healthy Blitz community and project. They take a lot of burden off the core team and level 2 maintainers so they can focus on higher level things with longer term impact.
+
+The primary responsibilities of level 1 maintainers are:
+
+- Being a friendly, welcoming voice for the Blitz community
+- Issue triage
+- Pull request triage
+- Monitor and answer the `#-help` slack channel
+- Community encouragement
+- Community moderation
+- Tracking and ensuring progress of key issues
+
+## Level 2 Maintainers
+
+Level 2 maintainers are the backbone of the project. They are watchdogs over the code, ensuring code quality, correctness, and security. They also facilitate a rapid pace of progress.
+
+The primary responsibilities of level 2 maintainers are:
+
+- Code ownership over specific parts of the project
+- Maintaining and improving the architecture of what they own
+- Final pull request reviews
+- Merging pull requests
+- Tracking and ensuring progress of open pull requests
+
+## ⚠️ Fundamentals
+
+Maintainers are the face of the project and the front-line touch point for the community. Therefore maintainers have the very important responsibility of making people feel welcome, valued, understood, and appreciated.
+
+**Please take time to read and understand everything outlined in this [guide on building welcoming communities](https://opensource.guide/building-community)**
+
+Some especially important points:
+
+- **Gratitude:** immediately express gratitude when someone opens an issue or PR. This takes effort/time and we appreciate it
+- **Responsiveness:** during issue/PR triage, even if we can’t do a full review right away, leave a comment thanking them and saying we’ll review it soon
+- **Understanding:** it's critical to ensure you understand exactly what someone is saying before you respond. Ask plenty of questions if needed. It's very bad if someone has to reply to your response and say "actually I was asking about X"
+  - In fact, at least one question is almost always required before you can respond appropriately  — whether in Github or in Slack
+
+## Slack
+
+- All `#-*` channels are for Blitz users
+- All `#dev-*` channels are for Blitz internal development
+
+If someone that's not a maintainer post in the wrong area, that's fine. Don't tell them they posted in the wrong place. But as a maintainer, you should for sure post in the right channel :)
+
+## Issue Triage
+
+#### If a bug report:
+
+- Does it have enough information? Versions? Logs? Some way to reproduce?
+- Has this already been fixed in a previous release?
+- Is there already an existing issue for this?
+
+### If a feature/change request:
+
+- Is it clear what the request is and what the benefit will be?
+- Is this an obvious win for Blitz? Then accept it
+- If not obvious, then pull in a core team member or level 2 maintainer for more review
+
+### Actions
+
+1. Add tags:
+   - Add a `kind/*` tag
+   - Add a `scope/*` tag
+   - Add a `status/*` tag
+   - Add a good first/second issue tag if appropriate
+
+## Pull Request Triage
+
+- Are the changes covered by tests?
+- Do the changes look ok? Make sure there's no obvious issues
+
+### Actions
+
+1. Kindly request any changes if needed
+2. Else add a Github approval so that level 2 maintainers know it's already had an initial review
+
+## Final PR Review & Merging (Level 2 maintainers)
+
+As a level 2 maintainer, it is your responsibility to make sure broken code and regressions never reach the canary branch.
+
+1. Ensure the PR'ed code fully works as intended and that there are no regressions in related code
+   1. If not fully covered by automated tests, you need to pull down the code locally and manually verify everything (the Github CLI helps with this!)
+2. During squash & merge:
+   1. Change the commit title to be public friendly - this exact text will go in the release notes
+   2. Add the commit type in the description, in parenthesis like `(patch)`. Commit types:
+      - `major` - major breaking change
+      - `minor` - minor feature addition
+      - `patch` - patches, bug fixes, perf improvements, etc
+      - `example` - change to an example app
+      - `meta` - internal meta change related to the Blitz repo/project

MANIFESTO.md

@@ -0,0 +1,3 @@
+# Manifesto
+
+[The Manifesto has been moved to Blitzjs.com](https://blitzjs.com/docs/manifesto)

MEETING_NOTES.md

@@ -0,0 +1,107 @@
+# 2020-07-07 Blitz Contributor Call
+
+- Attending: Brandon Bayer, Robert Rosenburg, Jeremy Liberman
+- Brandon:
+  - Finishing up session managment code
+  - Waiting for review of session managment code from Rishabh
+  - Will be working on actual auth code (vs session management) like password hashing, password reset, social login, etc.
+  - Benefits of our session managment vs rails
+    - Don’t have to redirect to login page
+    - Using top level error component that catches authentication errors
+    - You can login from anywhere, during sign up
+- Robert:
+  - Waiting on Kirstina’s website designs. Desktop design is finished, but she's working on mobile design
+  - Code snippet / sandbox of blitz code for the website
+
+# 2020-06-23 Blitz Contributor Call
+
+- Attending: Brandon Bayer, Robert Rosenberg, Justin Hall, Adam Markon
+- Brandon:
+  - Server side session management code is mostly set up. Still need to integrate client side of RPC calls to expose session information
+  - Identity verification/Oauth integrations still need to be firmed up
+  - Once auth is wrapped up we should be ready to start on plugins
+- Adam:
+  - Been experimenting with smart page generation based on the current schema model
+  - MDX installer recipes
+- Robert:
+  - Waiting on designs from Kristina
+  - Prism component from theme ui customization? If not try and grab source code from docusaurus line highlighting component
+- Justin:
+  - Updated the tutorial
+  - Helped with various bug fixes
+
+# 2020-06-17 Blitz Contributor Call
+
+- Attending: Brandon Bayer, Fran Zekan, Sigurd Wahl
+- Brandon:
+  - Spent the past week implementing HTTP middlware which is now released!
+  - Now working on implementing session management!
+- Fran:
+  - Finishing up the PR for adding `blitz db seed`
+- Sigurd:
+  - New to the community, slowly learning the codebase
+  - Exicited to get a first PR in here sometime soon :)
+
+# 2020-06-09 Blitz Contributor Call
+
+- Attending: Brandon Bayer, Rudi Yardley, Fran Zekan, Adam Markon, Robert Rosenberg, Kristina Matuska
+- Brandon:
+  - blitzjs.com published, docs + marketing site v0.1 live
+  - For now most of the docs copied from react-query and Next, we should eventually clean them up so they're stylistically similar to ours, but really easy to start
+  - HTTP middleware is almost done, just fixing a few edge cases
+  - Authentication is up next after that, translating pseudocode into actual code
+- Kristina:
+  - Homepage design mostly wrapped up right now, have to finish up mobile and light mode and then ready to move on to the rest of the docs
+  - Syntax highlighting, we can customize colors
+  - Sidebar inspiration from tailwindcss
+- Robert:
+  - Decided to wait to convert existing components to theme UI until the final design is done
+  - More docs content:
+    - More guides
+    - Improve the tutorial to incorporate relationship generation
+  - Add branches for canary and master
+    - If you add a feature you can add your documentation to the canary branch
+- Adam:
+  - blitz generate model finished!
+  - Installer rewrite complete
+    - At similar place to what Gatsby has for installing stuff
+  - Next up:
+    - Support gatsby MDX recipes
+    - Make all code generators aware of actual model attributes
+- Fran:
+  - Working on a package for getting the blitz config anywhere - getConfig()
+  - Prevent app from "warming" the server when deployed as server rather than serverless
+  - Testing examples - e2e with cypress and unit tests with Jest so we can link to a testing setup in the docs/getting started guide
+- Rudi:
+  - Extracted out the @blitzjs/file-pipeline (previously synchronizer)
+  - Extracted out the @blitzjs/display package
+  - Working on various Next.js compatibility issues
+  - Debugging a bug in blitz start where it gets stuck at \_manifest.json
+
+# 2020-05-26 Blitz Contributor Call
+
+- Attending: Brandon Bayer, Robert Rosenberg, Adam Markon, Simon Debbarma
+- Brandon:
+  - Kitze livestream last week went great — recording on youtube
+  - Codebase walkthrough yesterday went great — recording on youtube
+  - Website overhaul, installed Theme UI
+- Adam:
+  - Opened PR for Prisma model generation from the CLI
+  - Working on Installer stuff and prepping for integration with Gatsby recipes
+- Simon
+  - Working on custom illustrations for the web
+- Robert
+  - Misc work on website
+- Website
+  - Most website components are owned by us now instead of docusaurus, we'll need to be weary of api updates and any other important component updates
+  - Make sidebar like tailwind docs sidebar
+  - Dark theme needs to be fixed
+  - Theme switcher inconsistent
+  - Live code sandbox examples
+  - Code comparison between blitz and rails
+- Auth
+  - Rishabh continuing to work on pseudo code for the session management library
+  - Brandon planning to build http middleware support this week
+- CLI
+  - Adam working on new features, including generating prisma models and making existing templates aware of actual model attributes
+  - Plugin ideas / discussion once recipes are farther along. Will post an RFC for plugins at some point

README.md

@@ -1,2 +1,322 @@
-# blitz
-Framework for building monolithic, full-stack, serverless React apps with zero data-fetching and zero client-side state management
+[![Blitz.js](https://raw.githubusercontent.com/blitz-js/art/master/github-cover-photo.png)](https://blitzjs.com)
+
+<!-- prettier-ignore-start -->
+<p align="center">
+  <a aria-label="Join our Slack Community" href="https://slack.blitzjs.com">
+    <img alt="" src="https://img.shields.io/badge/Join%20our%20community-6700EB.svg?style=for-the-badge&labelColor=000000&logoWidth=20&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAIAAAACACAYAAADDPmHLAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAQ9SURBVHgB7d3dVdtAEIbhcSpICUoH0IEogQqSVBBSAU4FSSpIOoAORAfQgSghHXzZ1U/YcMD4R9rZmf2ec3y448LyiNf27iLiGIAmPLrweC9Un3DhrzG6EarLNP09nlwJ1SOZ/lQr5N80/S/p2QMVCBf5N17XCfm1Y/rBHqjAG9PPHvBsz+mf9WAP+HLA9M/YA14cOP2payH7jpj+VCtk1wnTP+vj7xCy6cTpn7EHLMLp059iD1iD8eveJbVCNsSLheX1YA/YgOWnf8YeKB3Wmf7Ud6Fy4f/FHmtpxbl3YlC4MJ/Cj0bWdwPnPbARg+L0S54XQHS32WwuxClzd4CM0z9rPfeAuTtA5ulPXYQ7wZ04Y+oOoDD9KZc9YOoOoDj9s4dwFzgXR6w1wIPoOvPWA9buAHEJ173o3gWiy3AnuBUHLEbgmYwvAk1/wuM8vAgexThzbwPDkx7/DHwVXfFOxP2GmsKd4Ab6zPeAyU8CI7AHFmH2BRCBPXAyk18GzUrqAXCTiR4ssyj0VFw/oCU8+e+RZ33AWz6KMaYbIIWxB+JSLs1bsbkeMN0AqakHvoku9oA2sAfqBvbAQdw0QArsgb25aYBUQT3QgT2gB+yBuqGcHij2UCqXDZACe2Anlw2QYg/QAOyBuoE98CL3DZDCuK4/rh/Q7oGL6U+TOvcNkJoijN8X1C48+T+g75eQDrAH/qmqAVJgDwyqaoAUe4AGYA/UDZX3QLUNkEIZPRCd5+6BahsgVUgPROwBTSijB7jpVAvGHriHvmw9wAZ4BpX1ABvgmakHtPcbRuwBTWAPULgAV9D/jKDY9YRvwvgEaurD44uQHvAol7qBW7WKluVtIHiUS7GyvA0s6CiXDnxrpQfsgbqBS7GKk/2jYHCrVlGyfxTMrVo0ALdq1Q3sgSKofh0M9oA61a+D2QM0AHugbmAPqClmSRjK2apVVQ8UsySsoK1aHdgDesCtWnUDeyCrIpeFg1u3sylyWTi3btMA7IG6gT2wuuK3hoE9sKrit4YVslWLPaAN7IG6ocKt2zmY2h4O9sDiTG0PZw/QANy6XTewBxZj9ogYVHy025LMHhEz9cBn0We6B0yfERReBLfhx0/R1YQHPx/QBPbA0VwcEwf2wNFcHBPHHjiem3MC2QPHcXdSaJjA+KfgTPQ8hhfjBzHC40mhlzJ+Xq9lK4a4PCs43AVaGTed5mZq+iOXZwWHi3AnOj2wFWNcnxYe7gTxLtBKHuamP/J+Wnh8a5irB7ZC5Yk9gPX1QuXC+usHWqGyhYvUYR0a7zboUOFCNVhnk0krZAOW7wFOvzXhom2xnEbIHizTA1wEYhWW6YFGyC6c1gOcfg9wfA80Qj7g8B7g9HuCww+haIR8wf49wOn3Cvv9k8tGyC/s7gFOv3fY3QONkH+v9MBWqB7PeqDn9FcIT//kcitUn6kHOu/T/xfWzlQy3dEHhwAAAABJRU5ErkJggg==">
+  </a>
+<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
+<a aria-label="All Contributors" href="#contributors-"><img alt="" src="https://img.shields.io/badge/all_contributors-82-17BB8A.svg?style=for-the-badge&labelColor=000000"></a>
+<!-- ALL-CONTRIBUTORS-BADGE:END -->
+  <a aria-label="License" href="https://github.com/blitz-js/blitz/blob/canary/LICENSE">
+    <img alt="" src="https://img.shields.io/npm/l/blitz.svg?style=for-the-badge&labelColor=000000&color=blue">
+  </a>
+  <a aria-label="NPM version" href="https://www.npmjs.com/package/blitz">
+    <img alt="" src="https://img.shields.io/npm/v/blitz.svg?style=for-the-badge&labelColor=000000&color=E65528">
+  </a>
+</p>
+<!-- prettier-ignore-end -->
+
+<br>
+
+<h1 align="center">The Fullstack React Framework</h1>
+
+<h5 align="center">"Zero-API" Data Layer — Built on Next.js — Inspired by Ruby on Rails</h3>
+<h3 align="center">Makes you far more productive than you ever dreamed was possible 😉</h3>
+<h3 align="center"><a href="https://blitzjs.com" target="_blank">Read the Documentation</a></h3>
+<br>
+
+“Zero-API” data layer **lets you import server code directly into your React components** instead of having to manually add API endpoints and do client-side fetching and caching.
+
+Includes everything you need for production apps. **Everything end-to-end from the database to the frontend.**
+
+Blitz brings back the **simplicity and conventions** of server-rendered frameworks like Ruby on Rails while preserving everything we love about React and client-side rendering!
+
+<br>
+
+### Quick Start
+
+You need Node.js 12 or newer
+
+#### Install Blitz
+
+Run `npm install -g blitz`
+
+#### Create a New App
+
+1. `blitz new myAppName`
+2. `cd myAppName`
+3. `blitz start`
+4. View your baby app at http://localhost:3000
+
+<br><br>
+
+![Architecture diagram](https://blitzjs.now.sh/img/architecture-diagram.png)
+
+<br><br>
+
+**Features:**<br>
+⚡️ Built on Next.js<br>
+⚡️ Don't have to build an API for client-side rendering<br>
+⚡️ Client-side rendering, Server-side rendering, and fully static pages all in the same app<br>
+⚡️ Full Typescript support with static, end-to-end typing (no code generation step needed like with GraphQL)<br>
+⚡️ React Concurrent Mode enabled<br>
+⚡️ Database/ORM agnostic, but Prisma 2 is default<br>
+⚡️ CLI with code scaffolding, Rails-style console REPL, etc<br>
+⚡️ GraphQL Ready<br>
+⚡️ Deploy serverless or serverful<br>
+
+**Other key features coming:**<br>
+⚡️ Highly secure authentication <br>
+⚡️ Authorization you can use on both server and client<br>
+⚡️ Model validation you can use on both server and client<br>
+⚡️ Plugins for easily adding libraries like Tailwind, CSS-in-JS, etc.<br>
+⚡️ React native support<br>
+⚡️ GUI so you don't have to use the CLI<br>
+
+<br>
+
+### The Foundational Principles
+
+1. Fullstack & Monolithic
+2. API Not Required
+3. Convention over Configuration
+4. Loose Opinions
+5. Easy to Start, Easy to Scale
+6. Stability
+7. Community over Code
+
+[The Blitz Manifesto](https://blitzjs.com/docs/manifesto) explains these principles in detail.
+
+<br>
+
+### What is Blitz Designed For?
+
+Blitz is designed for tiny to large database-backed applications that have one or more graphical user interfaces.
+
+While we currently only support web, we are pursuing the dream of a single monolithic application that runs on web and mobile with maximum code sharing and minimal boilerplate.
+
+<br>
+
+## Welcome to the Blitz Community 👋
+
+The Blitz community is warm, safe, diverse, inclusive, and fun! LGBTQ+, women, and minorities are especially welcome. Please read our [Code of Conduct](https://blitzjs.com/docs/code-of-conduct).
+
+[Join our Slack Community](https://slack.blitzjs.com) where we help each other build Blitz apps. It's also where we collaborate on building Blitz itself.
+
+For questions and longer form discussions, [post in our forum](https://github.com/blitz-js/blitz/discussions).
+
+There's still a lot of work to do, so you are especially invited to join us in building Blitz! A good place to start is [The Contributing Guide](https://blitzjs.com/docs/contributing).
+
+<br>
+
+## Financial Contributors
+
+Your financial contributions help ensure Blitz continues to be developed and maintained! We have monthly sponsorship options starting at $5/month.
+
+👉 View options and contribute at [GitHub Sponsors](https://github.com/sponsors/blitz-js), [PayPal](https://paypal.me/thebayers), or [Open Collective](https://opencollective.com/blitzjs)
+
+### 🥉 Bronze Sponsors
+
+—
+
+### 🥈 Silver Sponsors
+
+<a aria-label="Fauna" href="https://dashboard.fauna.com/accounts/register?utm_source=BlitzJS&utm_medium=sponsorship&utm_campaign=BlitzJS_Sponsorship_2020">
+<img alt="" src="https://raw.githubusercontent.com/blitz-js/blitz/canary/assets/Fauna_Logo_Blue.png" width="175px">
+</a>
+
+### 🏆 Gold Sponsors
+
+—
+
+### 💎 Diamond Sponsors
+
+—
+
+<br>
+
+## Core Team ✨
+
+<!-- markdownlint-disable -->
+<table>
+  <tr>
+    <td align="center"><a href="https://twitter.com/flybayer"><img src="https://avatars3.githubusercontent.com/u/8813276?v=4" width="100px;" alt=""/><br /><sub><b>Brandon Bayer</b></sub></a><br />Creator</td>
+    <td align="center"><a href="https://medium.com/@ryardley"><img src="https://avatars0.githubusercontent.com/u/1256409?v=4" width="100px;" alt=""/><br /><sub><b>Rudi Yardley</b></sub></a><br />Node.js Wizard</td>
+    <td align="center"><a href="https://merelinguist.now.sh"><img src="https://avatars3.githubusercontent.com/u/24858006?v=4" width="100px;" alt=""/><br /><sub><b>Dylan Brookes</b></sub></a><br />Friendly Generalist</td>
+  </tr>
+</table>
+<!-- markdownlint-enable -->
+
+
+<br>
+
+
+## Maintainers (Level 2) ✨
+
+_Code ownership, pull request approvals and merging, etc_ (see [MAINTAINERS.md](./MAINTAINERS.md))
+
+<!-- prettier-ignore-start -->
+<!-- markdownlint-disable -->
+<table>
+  <tr>
+    <td align="center"><a href="https://github.com/aem"><img src="https://avatars0.githubusercontent.com/u/1909883?v=4" width="100px;" alt=""/><br /><sub><b>Adam Markon</b></sub></a><br />CLI</td>
+    <td align="center"><a href="http://robdrosenberg.com"><img src="https://avatars0.githubusercontent.com/u/20813991?v=4" width="100px;" alt=""/><br /><sub><b>Robert Rosenberg</b></sub></a><br />Website/Docs</td>
+  </tr>
+</table>
+<!-- markdownlint-enable -->
+<!-- prettier-ignore-end -->
+
+<br>
+
+## Maintainers (Level 1) ✨
+
+_Issue triage, pull request triage, community encouragement and moderation, etc_ (see [MAINTAINERS.md](./MAINTAINERS.md))
+
+We need more woman & nonbinary level 1 maintainers. See [MAINTAINERS.md](./MAINTAINERS.md) for what this entails
+
+
+<!-- prettier-ignore-start -->
+<!-- markdownlint-disable -->
+<table>
+  <tr>
+    <td align="center"><a href="https://github.com/LoriKarikari"><img src="https://avatars1.githubusercontent.com/u/7902980?v=4" width="100px;" alt=""/><br /><sub><b>Lori Karikari</b></sub></a></td>
+    <td align="center"><a href="https://corey-brown.com"><img src="https://avatars1.githubusercontent.com/u/12791148?v=4" width="100px;" alt=""/><br /><sub><b>Corey Brown</b></sub></a></td>
+    <td align="center"><a href="http://simonknott.de"><img src="https://avatars1.githubusercontent.com/u/14912729?v=4" width="100px;" alt=""/><br /><sub><b>Simon Knott</b></sub></a></td>
+    <td align="center"><a href="https://twitter.com/GeggsElias"><img src="https://avatars3.githubusercontent.com/u/22719177?v=4" width="100px;" alt=""/><br /><sub><b>Elias Johansson</b></sub></a></td>
+    <td align="center"><a href="http://jeremyliberman.com/"><img src="https://avatars3.githubusercontent.com/u/2754163?v=4" width="100px;" alt=""/><br /><sub><b>Jeremy Liberman</b></td>
+    <td align="center"><a href="http://jagascript.com"><img src="https://avatars0.githubusercontent.com/u/4562878?v=4" width="100px;" alt=""/><br /><sub><b>Jaga Santagostino</b></sub></a></td>
+    <td align="center"><a href="https://simonpeterdebbarma.com"><img src="https://avatars3.githubusercontent.com/u/31207418?v=4" width="100px;" alt=""/><br /><sub><b>Simon Debbarma</b></sub></a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/jclancy93"><img src="https://avatars2.githubusercontent.com/u/7850202?v=4" width="100px;" alt=""/><br /><sub><b>Jack Clancy</b></sub></a></td>
+    <td align="center"><a href="https://twitter.com/ivandevp"><img src="https://avatars3.githubusercontent.com/u/9284690?v=4" width="100px;" alt=""/><br /><sub><b>Ivan Medina</b></sub></a></td>
+  </tr>
+</table>
+<!-- markdownlint-enable -->
+<!-- prettier-ignore-end -->
+
+
+<br>
+
+## Contributors ✨
+
+Thanks to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
+
+<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
+<!-- prettier-ignore-start -->
+<!-- markdownlint-disable -->
+<table>
+  <tr>
+    <td align="center"><a href="https://twitter.com/flybayer"><img src="https://avatars3.githubusercontent.com/u/8813276?v=4" width="100px;" alt=""/><br /><sub><b>Brandon Bayer</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=flybayer" title="Code">💻</a> <a href="#content-flybayer" title="Content">🖋</a> <a href="#ideas-flybayer" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/blitz-js/blitz/pulls?q=is%3Apr+reviewed-by%3Aflybayer" title="Reviewed Pull Requests">👀</a></td>
+    <td align="center"><a href="https://medium.com/@ryardley"><img src="https://avatars0.githubusercontent.com/u/1256409?v=4" width="100px;" alt=""/><br /><sub><b>Rudi Yardley</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=ryardley" title="Code">💻</a> <a href="#ideas-ryardley" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/blitz-js/blitz/pulls?q=is%3Apr+reviewed-by%3Aryardley" title="Reviewed Pull Requests">👀</a> <a href="https://github.com/blitz-js/blitz/commits?author=ryardley" title="Tests">⚠️</a></td>
+    <td align="center"><a href="https://merelinguist.me"><img src="https://avatars3.githubusercontent.com/u/24858006?v=4" width="100px;" alt=""/><br /><sub><b>Dylan Brookes</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=merelinguist" title="Code">💻</a> <a href="#ideas-merelinguist" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/blitz-js/blitz/pulls?q=is%3Apr+reviewed-by%3Amerelinguist" title="Reviewed Pull Requests">👀</a> <a href="https://github.com/blitz-js/blitz/commits?author=merelinguist" title="Tests">⚠️</a> <a href="https://github.com/blitz-js/blitz/commits?author=merelinguist" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://github.com/aem"><img src="https://avatars0.githubusercontent.com/u/1909883?v=4" width="100px;" alt=""/><br /><sub><b>Adam Markon</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=aem" title="Code">💻</a> <a href="#ideas-aem" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/blitz-js/blitz/pulls?q=is%3Apr+reviewed-by%3Aaem" title="Reviewed Pull Requests">👀</a> <a href="https://github.com/blitz-js/blitz/commits?author=aem" title="Tests">⚠️</a> <a href="#maintenance-aem" title="Maintenance">🚧</a></td>
+    <td align="center"><a href="https://corey-brown.com"><img src="https://avatars1.githubusercontent.com/u/12791148?v=4" width="100px;" alt=""/><br /><sub><b>Corey Brown</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=coreybrown89" title="Code">💻</a> <a href="https://github.com/blitz-js/blitz/pulls?q=is%3Apr+reviewed-by%3Acoreybrown89" title="Reviewed Pull Requests">👀</a> <a href="#maintenance-coreybrown89" title="Maintenance">🚧</a></td>
+    <td align="center"><a href="https://github.com/LoriKarikari"><img src="https://avatars1.githubusercontent.com/u/7902980?v=4" width="100px;" alt=""/><br /><sub><b>Lori Karikari</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=LoriKarikari" title="Code">💻</a> <a href="https://github.com/blitz-js/blitz/pulls?q=is%3Apr+reviewed-by%3ALoriKarikari" title="Reviewed Pull Requests">👀</a> <a href="#maintenance-LoriKarikari" title="Maintenance">🚧</a> <a href="https://github.com/blitz-js/blitz/commits?author=LoriKarikari" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://twitter.com/GeggsElias"><img src="https://avatars3.githubusercontent.com/u/22719177?v=4" width="100px;" alt=""/><br /><sub><b>Elias Johansson</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=eliasjohansson" title="Code">💻</a> <a href="https://github.com/blitz-js/blitz/pulls?q=is%3Apr+reviewed-by%3Aeliasjohansson" title="Reviewed Pull Requests">👀</a> <a href="#maintenance-eliasjohansson" title="Maintenance">🚧</a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://fabulas.io"><img src="https://avatars1.githubusercontent.com/u/14793389?v=4" width="100px;" alt=""/><br /><sub><b>Michael Edelman </b></sub></a><br /><a href="#infra-medelman17" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a> <a href="https://github.com/blitz-js/blitz/commits?author=medelman17" title="Code">💻</a></td>
+    <td align="center"><a href="http://www.geistinteractive.com"><img src="https://avatars2.githubusercontent.com/u/316792?v=4" width="100px;" alt=""/><br /><sub><b>Todd Geist</b></sub></a><br /><a href="#financial-toddgeist" title="Financial">💵</a></td>
+    <td align="center"><a href="http://robdrosenberg.com"><img src="https://avatars0.githubusercontent.com/u/20813991?v=4" width="100px;" alt=""/><br /><sub><b>Robert Rosenberg</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=robdrosenberg" title="Code">💻</a> <a href="#maintenance-robdrosenberg" title="Maintenance">🚧</a> <a href="https://github.com/blitz-js/blitz/commits?author=robdrosenberg" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://github.com/quirk0o"><img src="https://avatars3.githubusercontent.com/u/5123725?v=4" width="100px;" alt=""/><br /><sub><b>Beata Obrok</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=quirk0o" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/tsawan"><img src="https://avatars3.githubusercontent.com/u/3263082?v=4" width="100px;" alt=""/><br /><sub><b>Tahir Awan</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=tsawan" title="Code">💻</a></td>
+    <td align="center"><a href="https://raluce.com"><img src="https://avatars1.githubusercontent.com/u/2454632?v=4" width="100px;" alt=""/><br /><sub><b>Camilo Gonzalez</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=camilo86" title="Code">💻</a></td>
+    <td align="center"><a href="http://da.nielkempner.com"><img src="https://avatars3.githubusercontent.com/u/2532112?v=4" width="100px;" alt=""/><br /><sub><b>Daniel Kempner</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=dkempner" title="Code">💻</a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="http://gielcobben.com"><img src="https://avatars0.githubusercontent.com/u/2663212?v=4" width="100px;" alt=""/><br /><sub><b>Giel</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=gielcobben" title="Code">💻</a></td>
+    <td align="center"><a href="http://jeremyliberman.com/"><img src="https://avatars3.githubusercontent.com/u/2754163?v=4" width="100px;" alt=""/><br /><sub><b>Jeremy Liberman</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=MrLeebo" title="Code">💻</a> <a href="#maintenance-MrLeebo" title="Maintenance">🚧</a> <a href="https://github.com/blitz-js/blitz/commits?author=MrLeebo" title="Tests">⚠️</a></td>
+    <td align="center"><a href="https://jimthedev.com"><img src="https://avatars0.githubusercontent.com/u/108938?v=4" width="100px;" alt=""/><br /><sub><b>Jim Cummins</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=jimthedev" title="Code">💻</a></td>
+    <td align="center"><a href="http://kristinamatuska.com/"><img src="https://media-exp1.licdn.com/dms/image/C5603AQHVPAjV21gw9g/profile-displayphoto-shrink_200_200/0?e=1591228800&v=beta&t=0MlbmiYhNvGv1xjLD_fOhOFjVDZ7ltNwfGNeJ4DHedQ" width="100px;" alt=""/><br /><sub><b>Kristina Matuška</b></sub></a><br /><a href="#design" title="Design">🎨</a></td>
+    <td align="center"><a href="https://github.com/jasonblalock"><img src="https://avatars0.githubusercontent.com/u/5899929?v=4" width="100px;" alt=""/><br /><sub><b>Jason Blalock</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=jasonblalock" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/aej11a"><img src="https://avatars2.githubusercontent.com/u/10066422?v=4" width="100px;" alt=""/><br /><sub><b>aej11a</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=aej11a" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/marcoseoane"><img src="https://avatars0.githubusercontent.com/u/28088807?v=4" width="100px;" alt=""/><br /><sub><b>marcoseoane</b></sub></a><br /><a href="#ideas-marcoseoane" title="Ideas, Planning, & Feedback">🤔</a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/rishabhpoddar"><img src="https://avatars2.githubusercontent.com/u/2976287?v=4" width="100px;" alt=""/><br /><sub><b>Rishabh Poddar</b></sub></a><br /><a href="#ideas-rishabhpoddar" title="Ideas, Planning, & Feedback">🤔</a></td>
+    <td align="center"><a href="https://github.com/lorenzorapetti"><img src="https://avatars1.githubusercontent.com/u/2632174?v=4" width="100px;" alt=""/><br /><sub><b>Lorenzo Rapetti</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=lorenzorapetti" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/wKovacs64"><img src="https://avatars1.githubusercontent.com/u/1288694?v=4" width="100px;" alt=""/><br /><sub><b>Justin Hall</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=wKovacs64" title="Code">💻</a> <a href="https://github.com/blitz-js/blitz/commits?author=wKovacs64" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://github.com/sijad"><img src="https://avatars3.githubusercontent.com/u/7693001?v=4" width="100px;" alt=""/><br /><sub><b>Sajjad Hashemian</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=sijad" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/ETLopes"><img src="https://avatars3.githubusercontent.com/u/34959471?v=4" width="100px;" alt=""/><br /><sub><b>Eduardo Lopes</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=ETLopes" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/mattleff"><img src="https://avatars0.githubusercontent.com/u/120155?v=4" width="100px;" alt=""/><br /><sub><b>Matthew Leffler</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=mattleff" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://hew.tools"><img src="https://avatars0.githubusercontent.com/u/3103241?v=4" width="100px;" alt=""/><br /><sub><b>Matt</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=hew" title="Documentation">📖</a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/sonnypgs"><img src="https://avatars3.githubusercontent.com/u/1431300?v=4" width="100px;" alt=""/><br /><sub><b>Sonny</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=sonnypgs" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://github.com/Zeko369"><img src="https://avatars3.githubusercontent.com/u/3064377?v=4" width="100px;" alt=""/><br /><sub><b>Fran Zekan</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=Zeko369" title="Code">💻</a> <a href="https://github.com/blitz-js/blitz/commits?author=Zeko369" title="Documentation">📖</a></td>
+    <td align="center"><a href="http://twitter.com/JanBaykara"><img src="https://avatars2.githubusercontent.com/u/237556?v=4" width="100px;" alt=""/><br /><sub><b>Jan Baykara</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=janbaykara" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://mikeattara.com"><img src="https://avatars1.githubusercontent.com/u/31483629?v=4" width="100px;" alt=""/><br /><sub><b>Mike Perry Y Attara</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=mikeattara" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://devanthe.dev"><img src="https://avatars0.githubusercontent.com/u/354652?v=4" width="100px;" alt=""/><br /><sub><b>Devan</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=DevanB" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://github.com/jclancy93"><img src="https://avatars2.githubusercontent.com/u/7850202?v=4" width="100px;" alt=""/><br /><sub><b>Jack Clancy</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=jclancy93" title="Code">💻</a> <a href="#maintenance-jclancy93" title="Maintenance">🚧</a></td>
+    <td align="center"><a href="https://github.com/ntgussoni"><img src="https://avatars0.githubusercontent.com/u/10161067?v=4" width="100px;" alt=""/><br /><sub><b>Nicolas Torres</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=ntgussoni" title="Tests">⚠️</a> <a href="https://github.com/blitz-js/blitz/commits?author=ntgussoni" title="Code">💻</a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="http://simonknott.de"><img src="https://avatars1.githubusercontent.com/u/14912729?v=4" width="100px;" alt=""/><br /><sub><b>Simon Knott</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=skn0tt" title="Code">💻</a> <a href="https://github.com/blitz-js/blitz/commits?author=skn0tt" title="Tests">⚠️</a> <a href="#maintenance-skn0tt" title="Maintenance">🚧</a></td>
+    <td align="center"><a href="http://jagascript.com"><img src="https://avatars0.githubusercontent.com/u/4562878?v=4" width="100px;" alt=""/><br /><sub><b>Jaga Santagostino</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=kandros" title="Code">💻</a> <a href="https://github.com/blitz-js/blitz/commits?author=kandros" title="Documentation">📖</a> <a href="#maintenance-kandros" title="Maintenance">🚧</a></td>
+    <td align="center"><a href="http://www.joaoportela.com"><img src="https://avatars0.githubusercontent.com/u/1010018?v=4" width="100px;" alt=""/><br /><sub><b>João Portela</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=jportela" title="Code">💻</a></td>
+    <td align="center"><a href="http://dajin.dev"><img src="https://avatars0.githubusercontent.com/u/7122182?v=4" width="100px;" alt=""/><br /><sub><b>Da-Jin Chu</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=dajinchu" title="Code">💻</a></td>
+    <td align="center"><a href="https://shinyaigeek.dev/"><img src="https://avatars1.githubusercontent.com/u/42742053?v=4" width="100px;" alt=""/><br /><sub><b>Shinobu Hayashi</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=Shinyaigeek" title="Code">💻</a></td>
+    <td align="center"><a href="http://karankiri.com"><img src="https://avatars2.githubusercontent.com/u/19989161?v=4" width="100px;" alt=""/><br /><sub><b>Karan Kiri</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=karankiri" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/fullmetalengineer"><img src="https://avatars2.githubusercontent.com/u/5294903?v=4" width="100px;" alt=""/><br /><sub><b>Alan Long</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=fullmetalengineer" title="Documentation">📖</a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="http://codingsh.xyz"><img src="https://avatars2.githubusercontent.com/u/57037080?v=4" width="100px;" alt=""/><br /><sub><b>codingsh</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=developerfred" title="Code">💻</a></td>
+    <td align="center"><a href="http://twitter.com/peaonunes"><img src="https://avatars0.githubusercontent.com/u/3356720?v=4" width="100px;" alt=""/><br /><sub><b>Rafael Nunes</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/pulls?q=is%3Apr+reviewed-by%3Apeaonunes" title="Reviewed Pull Requests">👀</a> <a href="https://github.com/blitz-js/blitz/commits?author=peaonunes" title="Code">💻</a></td>
+    <td align="center"><a href="https://simonpeterdebbarma.com"><img src="https://avatars3.githubusercontent.com/u/31207418?v=4" width="100px;" alt=""/><br /><sub><b>Simon Debbarma</b></sub></a><br /><a href="#design-0ww" title="Design">🎨</a> <a href="#maintenance-0ww" title="Maintenance">🚧</a> <a href="https://github.com/blitz-js/blitz/commits?author=0ww" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://github.com/0xflotus"><img src="https://avatars3.githubusercontent.com/u/26602940?v=4" width="100px;" alt=""/><br /><sub><b>0xflotus</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=0xflotus" title="Code">💻</a> <a href="https://github.com/blitz-js/blitz/commits?author=0xflotus" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://dev.to/tmns"><img src="https://avatars3.githubusercontent.com/u/35785003?v=4" width="100px;" alt=""/><br /><sub><b>tmns</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=tmns" title="Code">💻</a> <a href="https://github.com/blitz-js/blitz/commits?author=tmns" title="Documentation">📖</a></td>
+    <td align="center"><a href="http://jruharris.com"><img src="https://avatars1.githubusercontent.com/u/8636691?v=4" width="100px;" alt=""/><br /><sub><b>Jru Harris</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=harris1717" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://twitter.com/ivandevp"><img src="https://avatars3.githubusercontent.com/u/9284690?v=4" width="100px;" alt=""/><br /><sub><b>Ivan Medina</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=ivandevp" title="Code">💻</a> <a href="#maintenance-ivandevp" title="Maintenance">🚧</a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://www.dwightwatson.com"><img src="https://avatars3.githubusercontent.com/u/1100408?v=4" width="100px;" alt=""/><br /><sub><b>Dwight Watson</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=dwightwatson" title="Code">💻</a></td>
+    <td align="center"><a href="http://is2ei.com/"><img src="https://avatars3.githubusercontent.com/u/3948353?v=4" width="100px;" alt=""/><br /><sub><b>Horie Issei</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=is2ei" title="Code">💻</a></td>
+    <td align="center"><a href="https://twitter.com/lednhatkhanh"><img src="https://avatars2.githubusercontent.com/u/9303093?v=4" width="100px;" alt=""/><br /><sub><b>Nhat Khanh</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=lednhatkhanh" title="Code">💻</a></td>
+    <td align="center"><a href="https://builtforfifty.com"><img src="https://avatars1.githubusercontent.com/u/19371989?v=4" width="100px;" alt=""/><br /><sub><b>Abu Uzayr</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=abuuzayr" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/nabi009"><img src="https://avatars0.githubusercontent.com/u/3170831?v=4" width="100px;" alt=""/><br /><sub><b>Nabiullah elham</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=nabi009" title="Code">💻</a></td>
+    <td align="center"><a href="https://lachlanjc.com"><img src="https://avatars1.githubusercontent.com/u/5074763?v=4" width="100px;" alt=""/><br /><sub><b>Lachlan Campbell</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=lachlanjc" title="Code">💻</a></td>
+    <td align="center"><a href="http://enzoferey.com"><img src="https://avatars1.githubusercontent.com/u/10673347?v=4" width="100px;" alt=""/><br /><sub><b>Enzo Ferey</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=enzoferey" title="Code">💻</a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/pgrimaud"><img src="https://avatars1.githubusercontent.com/u/1866496?v=4" width="100px;" alt=""/><br /><sub><b>Pierre Grimaud</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=pgrimaud" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/jletey"><img src="https://avatars1.githubusercontent.com/u/62398724?v=4" width="100px;" alt=""/><br /><sub><b>John Letey</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=jletey" title="Code">💻</a></td>
+    <td align="center"><a href="https://pixelmord.github.io"><img src="https://avatars2.githubusercontent.com/u/224168?v=4" width="100px;" alt=""/><br /><sub><b>Andreas Adam</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=pixelmord" title="Code">💻</a></td>
+    <td align="center"><a href="https://kevo.dev"><img src="https://avatars3.githubusercontent.com/u/15717067?v=4" width="100px;" alt=""/><br /><sub><b>Kevin Tovar</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=kevotovar" title="Code">💻</a></td>
+    <td align="center"><a href="http://anteprimorac.com.hr"><img src="https://avatars0.githubusercontent.com/u/972083?v=4" width="100px;" alt=""/><br /><sub><b>Ante Primorac</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=anteprimorac" title="Code">💻</a> <a href="https://github.com/blitz-js/blitz/commits?author=anteprimorac" title="Documentation">📖</a></td>
+    <td align="center"><a href="http://mykalmachon.dev"><img src="https://avatars1.githubusercontent.com/u/7844994?v=4" width="100px;" alt=""/><br /><sub><b>Mykal Machon</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=MykalMachon" title="Code">💻</a></td>
+    <td align="center"><a href="https://jamiedavenport.dev"><img src="https://avatars2.githubusercontent.com/u/1329874?v=4" width="100px;" alt=""/><br /><sub><b>Jamie Davenport</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=jamiedavenport" title="Code">💻</a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://cloudnweb.dev/"><img src="https://avatars0.githubusercontent.com/u/17050715?v=4" width="100px;" alt=""/><br /><sub><b>GaneshMani</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=ganeshmani" title="Code">💻</a></td>
+    <td align="center"><a href="http://ramonmorcillo.com"><img src="https://avatars3.githubusercontent.com/u/31936665?v=4" width="100px;" alt=""/><br /><sub><b>reymon359</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=reymon359" title="Code">💻</a></td>
+    <td align="center"><a href="https://www.linkedin.com/in/gregory-vasquez-96413b184/"><img src="https://avatars1.githubusercontent.com/u/36422346?v=4" width="100px;" alt=""/><br /><sub><b>gvasquez11</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=gvasquez11" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/josemiguelo"><img src="https://avatars1.githubusercontent.com/u/15330034?v=4" width="100px;" alt=""/><br /><sub><b> José Miguel Ochoa</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=josemiguelo" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/osirvent"><img src="https://avatars2.githubusercontent.com/u/5927133?v=4" width="100px;" alt=""/><br /><sub><b>Oscar Sirvent</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=osirvent" title="Code">💻</a> <a href="https://github.com/blitz-js/blitz/commits?author=osirvent" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://github.com/donni106"><img src="https://avatars0.githubusercontent.com/u/1942953?v=4" width="100px;" alt=""/><br /><sub><b>Daniel Molnar</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=donni106" title="Documentation">📖</a> <a href="https://github.com/blitz-js/blitz/commits?author=donni106" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/exclipy"><img src="https://avatars1.githubusercontent.com/u/508799?v=4" width="100px;" alt=""/><br /><sub><b>Kevin Wu Won</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=exclipy" title="Documentation">📖</a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/tehnuge"><img src="https://avatars1.githubusercontent.com/u/1928236?v=4" width="100px;" alt=""/><br /><sub><b>John Duong</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=tehnuge" title="Code">💻</a></td>
+    <td align="center"><a href="https://noahfleischmann.com"><img src="https://avatars0.githubusercontent.com/u/23707137?v=4" width="100px;" alt=""/><br /><sub><b>Noah Fleischmann</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=fnoah" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/toshi1127"><img src="https://avatars3.githubusercontent.com/u/32378535?v=4" width="100px;" alt=""/><br /><sub><b>Matsumoto Toshi</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=toshi1127" title="Code">💻</a> <a href="https://github.com/blitz-js/blitz/commits?author=toshi1127" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://github.com/simonedelmann"><img src="https://avatars2.githubusercontent.com/u/2821076?v=4" width="100px;" alt=""/><br /><sub><b>Simon Edelmann</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=simonedelmann" title="Code">💻</a></td>
+    <td align="center"><a href="https://shaun.church"><img src="https://avatars3.githubusercontent.com/u/571764?v=4" width="100px;" alt=""/><br /><sub><b>Shaun Church</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=shaunchurch" title="Documentation">📖</a> <a href="https://github.com/blitz-js/blitz/commits?author=shaunchurch" title="Code">💻</a></td>
+    <td align="center"><a href="https://styfle.dev"><img src="https://avatars1.githubusercontent.com/u/229881?v=4" width="100px;" alt=""/><br /><sub><b>Steven</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=styfle" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://github.com/SigurdMW"><img src="https://avatars3.githubusercontent.com/u/6359003?v=4" width="100px;" alt=""/><br /><sub><b>Sigurd Moland Wahl</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=SigurdMW" title="Code">💻</a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://brianandrews.dev/"><img src="https://avatars1.githubusercontent.com/u/6384100?v=4" width="100px;" alt=""/><br /><sub><b>Brian Andrews</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=sbardian" title="Documentation">📖</a></td>
+    <td align="center"><a href="http://garrisonsnelling.com"><img src="https://avatars0.githubusercontent.com/u/5100597?v=4" width="100px;" alt=""/><br /><sub><b>Garrison Snelling</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=garrisons" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://github.com/tylangesmith"><img src="https://avatars1.githubusercontent.com/u/22609577?v=4" width="100px;" alt=""/><br /><sub><b>Ty Lange-Smith</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=tylangesmith" title="Code">💻</a></td>
+    <td align="center"><a href="https://rubenmoya.dev"><img src="https://avatars3.githubusercontent.com/u/905225?v=4" width="100px;" alt=""/><br /><sub><b>Rubén Moya</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=rubenmoya" title="Code">💻</a> <a href="https://github.com/blitz-js/blitz/commits?author=rubenmoya" title="Tests">⚠️</a></td>
+    <td align="center"><a href="https://github.com/robertgrzonka"><img src="https://avatars0.githubusercontent.com/u/35585466?v=4" width="100px;" alt=""/><br /><sub><b>robertgrzonka</b></sub></a><br /><a href="https://github.com/blitz-js/blitz/commits?author=robertgrzonka" title="Code">💻</a> <a href="#infra-robertgrzonka" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a></td>
+  </tr>
+</table>
+
+<!-- markdownlint-enable -->
+<!-- prettier-ignore-end -->
+<!-- ALL-CONTRIBUTORS-LIST:END -->
+
+This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!

__mocks__/fs.js

@@ -0,0 +1,3 @@
+const {fs} = require("memfs")
+
+module.exports = fs

examples/auth/.babelrc.js

@@ -0,0 +1,4 @@
+module.exports = {
+  presets: ["next/babel"],
+  plugins: [],
+}

examples/auth/.eslintrc.js

@@ -0,0 +1,14 @@
+module.exports = {
+  extends: ["react-app", "plugin:jsx-a11y/recommended"],
+  plugins: ["jsx-a11y", "cypress"],
+  rules: {
+    "import/no-anonymous-default-export": "error",
+    "import/no-webpack-loader-syntax": "off",
+    "react/react-in-jsx-scope": "off", // React is always in scope with Blitz
+    "jsx-a11y/anchor-is-valid": "off", //Doesn't play well with Blitz/Next <Link> usage
+    "jsx-a11y/label-has-associated-control": "off", //Doesn't play well with form libraries
+  },
+  env: {
+    "cypress/globals": true,
+  },
+}

examples/auth/.gitignore

@@ -0,0 +1,57 @@
+# dependencies
+node_modules
+.yarn/cache
+.yarn/unplugged
+.yarn/build-state.yml
+.pnp.*
+.npm
+web_modules/
+
+# blitz
+/.blitz/
+/.next/
+*.sqlite
+.now
+.blitz-console-history
+blitz-log.log
+
+# misc
+.DS_Store
+
+# local env files
+.env
+.envrc
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# Logs
+logs
+*.log
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Testing
+coverage
+*.lcov
+.nyc_output
+lib-cov
+
+# Caches
+*.tsbuildinfo
+.eslintcache
+.node_repl_history
+.yarn-integrity
+
+# Serverless directories
+.serverless/
+
+# Stores VSCode versions used for testing VSCode extensions
+.vscode-test
+
+.vercel

examples/auth/.npmrc

@@ -0,0 +1 @@
+save-exact=true

examples/auth/.prettierignore

@@ -0,0 +1,5 @@
+.gitkeep
+.env*
+*.ico
+*.lock
+db/migrations

examples/auth/.vercelignore

@@ -0,0 +1,2 @@
+.blitz
+*.sqlite

examples/auth/README.md

@@ -0,0 +1,26 @@
+# auth
+
+## Getting Started
+
+1. Add this code to db/schema.prisma:
+
+```
+model Project {
+  id      Int      @default(autoincrement()) @id
+  name    String
+}
+```
+
+2. DB migrate
+
+```
+blitz db migrate
+```
+
+3. Start the dev server
+
+```
+blitz start
+```
+
+Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.

examples/auth/app/api/auth/[...auth].ts

@@ -0,0 +1,89 @@
+import {passportAuth} from "blitz"
+import db from "db"
+import {Strategy as TwitterStrategy} from "passport-twitter"
+import {Strategy as GitHubStrategy} from "passport-github2"
+
+function assert(condition: any, message: string): asserts condition {
+  if (!condition) throw new Error(message)
+}
+
+// These aren't required, but this is a good practice to ensure you have the env vars you need
+assert(process.env.TWITTER_CONSUMER_KEY, "You must provide the TWITTER_CONSUMER_KEY env variable")
+assert(
+  process.env.TWITTER_CONSUMER_SECRET,
+  "You must provide the TWITTER_CONSUMER_SECRET env variable",
+)
+assert(process.env.GITHUB_CLIENT_ID, "You must provide the GITHUB_CLIENT_ID env variable")
+assert(process.env.GITHUB_CLIENT_SECRET, "You must provide the GITHUB_CLIENT_SECRET env variable")
+
+export default passportAuth({
+  successRedirectUrl: "/",
+  strategies: [
+    new TwitterStrategy(
+      {
+        consumerKey: process.env.TWITTER_CONSUMER_KEY,
+        consumerSecret: process.env.TWITTER_CONSUMER_SECRET,
+        callbackURL:
+          process.env.NODE_ENV === "production"
+            ? "https://auth-example-flybayer.blitzjs.vercel.app/api/auth/twitter/callback"
+            : "http://localhost:3000/api/auth/twitter/callback",
+        includeEmail: true,
+      },
+      async function (_token, _tokenSecret, profile, done) {
+        const email = profile.emails && profile.emails[0]?.value
+
+        if (!email) {
+          // This can happen if you haven't enabled email access in your twitter app permissions
+          return done(new Error("Twitter OAuth response doesn't have email."))
+        }
+
+        const user = await db.user.upsert({
+          where: {email},
+          create: {
+            email,
+            name: profile.displayName,
+          },
+          update: {email},
+        })
+
+        const publicData = {userId: user.id, roles: [user.role], source: "twitter"}
+        done(null, {publicData})
+      },
+    ),
+    new GitHubStrategy(
+      {
+        clientID: process.env.GITHUB_CLIENT_ID,
+        clientSecret: process.env.GITHUB_CLIENT_SECRET,
+        callbackURL:
+          process.env.NODE_ENV === "production"
+            ? "https://auth-example-flybayer.blitzjs.vercel.app/api/auth/github/callback"
+            : "http://localhost:3000/api/auth/github/callback",
+      },
+      async function (_token, _tokenSecret, profile, done) {
+        const email = profile.emails && profile.emails[0]?.value
+
+        if (!email) {
+          // This can happen if you haven't enabled email access in your twitter app permissions
+          return done(new Error("Twitter OAuth response doesn't have email."))
+        }
+
+        const user = await db.user.upsert({
+          where: {email},
+          create: {
+            email,
+            name: profile.displayName,
+          },
+          update: {email},
+        })
+
+        const publicData = {
+          userId: user.id,
+          roles: [user.role],
+          source: "github",
+          githubUsername: profile.username,
+        }
+        done(null, {publicData})
+      },
+    ),
+  ],
+})

examples/auth/app/auth/components/LoginForm.tsx

@@ -0,0 +1,43 @@
+import React from "react"
+import {LabeledTextField} from "app/components/LabeledTextField"
+import {Form, FORM_ERROR} from "app/components/Form"
+import login from "app/auth/mutations/login"
+import {LoginInput, LoginInputType} from "app/auth/validations"
+
+type LoginFormProps = {
+  onSuccess?: () => void
+}
+
+export const LoginForm = (props: LoginFormProps) => {
+  return (
+    <div>
+      <h1>Login</h1>
+
+      <Form<LoginInputType>
+        submitText="Log In"
+        schema={LoginInput}
+        initialValues={{email: undefined, password: undefined}}
+        onSubmit={async (values) => {
+          try {
+            await login({email: values.email, password: values.password})
+            props.onSuccess && props.onSuccess()
+          } catch (error) {
+            if (error.name === "AuthenticationError") {
+              return {[FORM_ERROR]: "Sorry, those credentials are invalid"}
+            } else {
+              return {
+                [FORM_ERROR]:
+                  "Sorry, we had an unexpected error. Please try again. - " + error.toString(),
+              }
+            }
+          }
+        }}
+      >
+        <LabeledTextField name="email" label="Email" placeholder="Email" />
+        <LabeledTextField name="password" label="Password" placeholder="Password" type="password" />
+      </Form>
+    </div>
+  )
+}
+
+export default LoginForm

examples/auth/app/auth/index.ts

@@ -0,0 +1,34 @@
+import {AuthenticationError} from "blitz"
+import SecurePassword from "secure-password"
+import db, {User} from "db"
+
+const SP = new SecurePassword()
+
+export const hashPassword = async (password: string) => {
+  const hashedBuffer = await SP.hash(Buffer.from(password))
+  return hashedBuffer.toString("base64")
+}
+export const verifyPassword = async (hashedPassword: string, password: string) => {
+  return await SP.verify(Buffer.from(password), Buffer.from(hashedPassword, "base64"))
+}
+
+export const authenticateUser = async (email: string, password: string) => {
+  const user = await db.user.findOne({where: {email}})
+
+  if (!user || !user.hashedPassword) throw new AuthenticationError()
+
+  switch (await verifyPassword(user.hashedPassword, password)) {
+    case SecurePassword.VALID:
+      break
+    case SecurePassword.VALID_NEEDS_REHASH:
+      // Upgrade hashed password with a more secure hash
+      const improvedHash = await hashPassword(password)
+      await db.user.update({where: {id: user.id}, data: {hashedPassword: improvedHash}})
+      break
+    default:
+      throw new AuthenticationError()
+  }
+
+  delete user.hashedPassword
+  return user as Omit<User, "hashedPassword">
+}

examples/auth/app/auth/mutations/login.ts

@@ -0,0 +1,15 @@
+import {SessionContext} from "blitz"
+import {authenticateUser} from "app/auth"
+import {LoginInput, LoginInputType} from "../validations"
+
+export default async function login(input: LoginInputType, ctx: {session?: SessionContext} = {}) {
+  // This throws an error if input is invalid
+  const {email, password} = LoginInput.parse(input)
+
+  // This throws an error if credentials are invalid
+  const user = await authenticateUser(email, password)
+
+  await ctx.session!.create({userId: user.id, roles: [user.role]})
+
+  return user
+}

examples/auth/app/auth/mutations/logout.ts

@@ -0,0 +1,5 @@
+import {SessionContext} from "blitz"
+
+export default async function logout(_ = null, ctx: {session?: SessionContext} = {}) {
+  return await ctx.session!.revoke()
+}

examples/auth/app/auth/mutations/signup.ts

@@ -0,0 +1,19 @@
+import db from "db"
+import {SessionContext} from "blitz"
+import {hashPassword} from "app/auth"
+import {SignupInput, SignupInputType} from "app/auth/validations"
+
+export default async function signup(input: SignupInputType, ctx: {session?: SessionContext} = {}) {
+  // This throws an error if input is invalid
+  const {email, password} = SignupInput.parse(input)
+
+  const hashedPassword = await hashPassword(password)
+  const user = await db.user.create({
+    data: {email, hashedPassword, role: "user"},
+    select: {id: true, name: true, email: true, role: true},
+  })
+
+  await ctx.session!.create({userId: user.id, roles: [user.role]})
+
+  return user
+}

examples/auth/app/auth/pages/login.tsx

@@ -0,0 +1,22 @@
+import React from "react"
+import {Head, useRouter, BlitzPage} from "blitz"
+import {LoginForm} from "app/auth/components/LoginForm"
+
+const SignupPage: BlitzPage = () => {
+  const router = useRouter()
+
+  return (
+    <>
+      <Head>
+        <title>Log In</title>
+        <link rel="icon" href="/favicon.ico" />
+      </Head>
+
+      <div>
+        <LoginForm onSuccess={() => router.push("/")} />
+      </div>
+    </>
+  )
+}
+
+export default SignupPage

examples/auth/app/auth/pages/signup.tsx

@@ -0,0 +1,51 @@
+import React from "react"
+import {Head, useRouter, BlitzPage} from "blitz"
+import {Form, FORM_ERROR} from "app/components/Form"
+import {LabeledTextField} from "app/components/LabeledTextField"
+import signup from "app/auth/mutations/signup"
+import {SignupInput, SignupInputType} from "app/auth/validations"
+
+const SignupPage: BlitzPage = () => {
+  const router = useRouter()
+
+  return (
+    <>
+      <Head>
+        <title>Sign Up</title>
+        <link rel="icon" href="/favicon.ico" />
+      </Head>
+
+      <div>
+        <h1>Create an Account</h1>
+
+        <Form<SignupInputType>
+          submitText="Create Account"
+          schema={SignupInput}
+          onSubmit={async (values) => {
+            try {
+              await signup({email: values.email, password: values.password})
+              router.push("/")
+            } catch (error) {
+              if (error.code === "P2002" && error.meta?.target?.includes("email")) {
+                // This error comes from Prisma
+                return {email: "This email is already being used"}
+              } else {
+                return {[FORM_ERROR]: error.toString()}
+              }
+            }
+          }}
+        >
+          <LabeledTextField name="email" label="Email" placeholder="Email" />
+          <LabeledTextField
+            name="password"
+            label="Password"
+            placeholder="Password"
+            type="password"
+          />
+        </Form>
+      </div>
+    </>
+  )
+}
+
+export default SignupPage

examples/auth/app/auth/validations.ts

@@ -0,0 +1,13 @@
+import * as z from "zod"
+
+export const SignupInput = z.object({
+  email: z.string().email(),
+  password: z.string().min(10).max(100),
+})
+export type SignupInputType = z.infer<typeof SignupInput>
+
+export const LoginInput = z.object({
+  email: z.string().email(),
+  password: z.string(),
+})
+export type LoginInputType = z.infer<typeof LoginInput>

examples/auth/app/components/Form.tsx

@@ -0,0 +1,62 @@
+import React, {ReactNode, PropsWithoutRef} from "react"
+import {Form as FinalForm, FormProps as FinalFormProps} from "react-final-form"
+import * as z from "zod"
+export {FORM_ERROR} from "final-form"
+
+type FormProps<FormValues> = {
+  /** All your form fields */
+  children: ReactNode
+  /** Text to display in the submit button */
+  submitText: string
+  onSubmit: FinalFormProps<FormValues>["onSubmit"]
+  initialValues?: FinalFormProps<FormValues>["initialValues"]
+  schema?: z.ZodType<any, any>
+} & Omit<PropsWithoutRef<JSX.IntrinsicElements["form"]>, "onSubmit">
+
+export function Form<FormValues extends Record<string, unknown>>({
+  children,
+  submitText,
+  schema,
+  initialValues,
+  onSubmit,
+  ...props
+}: FormProps<FormValues>) {
+  return (
+    <FinalForm<FormValues>
+      initialValues={initialValues}
+      validate={(values) => {
+        if (!schema) return
+        try {
+          schema.parse(values)
+        } catch (error) {
+          return error.formErrors.fieldErrors
+        }
+      }}
+      onSubmit={onSubmit}
+      render={({handleSubmit, submitting, submitError}) => (
+        <form onSubmit={handleSubmit} className="form" {...props}>
+          {/* Form fields supplied as children are rendered here */}
+          {children}
+
+          {submitError && (
+            <div role="alert" style={{color: "red"}}>
+              {submitError}
+            </div>
+          )}
+
+          <button type="submit" disabled={submitting}>
+            {submitText}
+          </button>
+
+          <style global jsx>{`
+            .form > * + * {
+              margin-top: 1rem;
+            }
+          `}</style>
+        </form>
+      )}
+    />
+  )
+}
+
+export default Form

examples/auth/app/components/LabeledTextField.tsx

@@ -0,0 +1,55 @@
+import React, {PropsWithoutRef} from "react"
+import {useField} from "react-final-form"
+
+export interface LabeledTextFieldProps extends PropsWithoutRef<JSX.IntrinsicElements["input"]> {
+  /** Field name. */
+  name: string
+  /** Field label. */
+  label: string
+  /** Field type. Doesn't include radio buttons and checkboxes */
+  type?: "text" | "password" | "email" | "number"
+  outerProps?: PropsWithoutRef<JSX.IntrinsicElements["div"]>
+}
+
+export const LabeledTextField = React.forwardRef<HTMLInputElement, LabeledTextFieldProps>(
+  ({name, label, outerProps, ...props}, ref) => {
+    const {
+      input,
+      meta: {touched, error, submitError, submitting},
+    } = useField(name)
+
+    return (
+      <div {...outerProps}>
+        <label>
+          {label}
+          <input {...input} disabled={submitting} {...props} ref={ref} />
+        </label>
+
+        {touched && (error || submitError) && (
+          <div role="alert" style={{color: "red"}}>
+            {error || submitError}
+          </div>
+        )}
+
+        <style jsx>{`
+          label {
+            display: flex;
+            flex-direction: column;
+            align-items: start;
+            font-size: 1rem;
+          }
+          input {
+            font-size: 1rem;
+            padding: 0.25rem 0.5rem;
+            border-radius: 3px;
+            border: 1px solid purple;
+            appearance: none;
+            margin-top: 0.5rem;
+          }
+        `}</style>
+      </div>
+    )
+  },
+)
+
+export default LabeledTextField

examples/auth/app/layouts/Layout.tsx

@@ -0,0 +1,22 @@
+import {useSession, useRouter} from "blitz"
+import logout from "app/auth/mutations/logout"
+
+export default function Layout({children}: {children: React.ReactNode}) {
+  const session = useSession()
+  const router = useRouter()
+  return (
+    <div>
+      {session.userId && (
+        <button
+          onClick={async () => {
+            router.push("/")
+            await logout()
+          }}
+        >
+          Logout
+        </button>
+      )}
+      <div>{children}</div>
+    </div>
+  )
+}

examples/auth/app/pages/404.tsx

@@ -0,0 +1,19 @@
+import {Head, ErrorComponent} from "blitz"
+
+// ------------------------------------------------------
+// This page is rendered if a route match is not found
+// ------------------------------------------------------
+export default function Page404() {
+  const statusCode = 404
+  const title = "This page could not be found"
+  return (
+    <>
+      <Head>
+        <title>
+          {statusCode}: {title}
+        </title>
+      </Head>
+      <ErrorComponent statusCode={statusCode} title={title} />
+    </>
+  )
+}

examples/auth/app/pages/_app.tsx

@@ -0,0 +1,36 @@
+import {AppProps, ErrorComponent} from "blitz"
+import {ErrorBoundary} from "react-error-boundary"
+import {queryCache} from "react-query"
+import LoginForm from "app/auth/components/LoginForm"
+
+export default function App({Component, pageProps}: AppProps) {
+  return (
+    <ErrorBoundary
+      FallbackComponent={RootErrorFallback}
+      onReset={() => {
+        // This ensures the Blitz useQuery hooks will automatically refetch
+        // data any time you reset the error boundary
+        queryCache.resetErrorBoundaries()
+      }}
+    >
+      <Component {...pageProps} />
+    </ErrorBoundary>
+  )
+}
+
+function RootErrorFallback({error, resetErrorBoundary}) {
+  if (error.name === "AuthenticationError") {
+    return <LoginForm onSuccess={resetErrorBoundary} />
+  } else if (error.name === "AuthorizationError") {
+    return (
+      <ErrorComponent
+        statusCode={error.statusCode}
+        title="Sorry, you are not authorized to access this"
+      />
+    )
+  } else {
+    return (
+      <ErrorComponent statusCode={error.statusCode || 400} title={error.message || error.name} />
+    )
+  }
+}

examples/auth/app/pages/_document.tsx

@@ -0,0 +1,23 @@
+import {Document, Html, DocumentHead, Main, BlitzScript /*DocumentContext*/} from "blitz"
+
+class MyDocument extends Document {
+  // Only uncomment if you need to customize this behaviour
+  // static async getInitialProps(ctx: DocumentContext) {
+  //   const initialProps = await Document.getInitialProps(ctx)
+  //   return {...initialProps}
+  // }
+
+  render() {
+    return (
+      <Html lang="en">
+        <DocumentHead />
+        <body>
+          <Main />
+          <BlitzScript />
+        </body>
+      </Html>
+    )
+  }
+}
+
+export default MyDocument

examples/auth/app/pages/index.tsx

@@ -0,0 +1,214 @@
+import {Head, Link, useSession, useRouterQuery} from "blitz"
+import getUser from "app/users/queries/getUser"
+import trackView from "app/users/mutations/trackView"
+import Layout from "app/layouts/Layout"
+
+const UserStuff = () => {
+  const session = useSession()
+  const query = useRouterQuery()
+  return (
+    <div>
+      {!session.userId && (
+        <>
+          <div style={{marginTop: "1rem"}}>
+            <Link href="/signup">Sign Up</Link>
+          </div>
+          <div>
+            <Link href="/login">Log In</Link>
+          </div>
+          <a href="/api/auth/twitter" style={{display: "block"}}>
+            Login with Twitter
+          </a>
+          <a href="/api/auth/github" style={{display: "block"}}>
+            Login with Github
+          </a>
+          {query.authError && <div style={{color: "red"}}>{query.authError}</div>}
+        </>
+      )}
+      <pre>{JSON.stringify(session, null, 2)}</pre>
+      <button
+        onClick={async () => {
+          try {
+            const user = await getUser({where: {id: session.userId as number}})
+            alert(JSON.stringify(user))
+          } catch (error) {
+            alert("error: " + JSON.stringify(error))
+          }
+        }}
+      >
+        Get user
+      </button>
+      <button
+        onClick={async () => {
+          try {
+            await trackView()
+          } catch (error) {
+            alert("error: " + error)
+            console.log(error)
+          }
+        }}
+      >
+        Track view
+      </button>
+    </div>
+  )
+}
+
+const Home = () => (
+  <Layout>
+    <div className="container">
+      <Head>
+        <title>auth</title>
+        <link rel="icon" href="/favicon.ico" />
+      </Head>
+
+      <main>
+        <div className="logo">
+          <img src="/logo.png" alt="blitz.js" />
+        </div>
+
+        <UserStuff />
+      </main>
+
+      <footer>
+        <a
+          href="https://blitzjs.com?utm_source=blitz-new&utm_medium=app-template&utm_campaign=blitz-new"
+          target="_blank"
+          rel="noopener noreferrer"
+        >
+          Powered by Blitz.js
+        </a>
+      </footer>
+
+      <style jsx>{`
+        .container {
+          min-height: 100vh;
+          display: flex;
+          flex-direction: column;
+          justify-content: center;
+          align-items: center;
+        }
+
+        main {
+          padding: 5rem 0;
+          flex: 1;
+          display: flex;
+          flex-direction: column;
+          justify-content: center;
+          align-items: center;
+        }
+
+        main p {
+          font-size: 1.2rem;
+        }
+
+        footer {
+          width: 100%;
+          height: 60px;
+          border-top: 1px solid #eaeaea;
+          display: flex;
+          justify-content: center;
+          align-items: center;
+          background-color: #45009d;
+        }
+
+        footer a {
+          display: flex;
+          justify-content: center;
+          align-items: center;
+        }
+
+        footer a {
+          color: #f4f4f4;
+          text-decoration: none;
+        }
+
+        .logo {
+          margin-bottom: 2rem;
+        }
+
+        .logo img {
+          width: 300px;
+        }
+
+        .buttons {
+          display: grid;
+          grid-template-columns: 1fr 1fr 1fr;
+          grid-gap: 0.5rem;
+          margin-top: 6rem;
+        }
+
+        a.button {
+          background-color: #6700eb;
+          padding: 1rem 2rem;
+          color: #f4f4f4;
+          text-align: center;
+        }
+
+        a.button:hover {
+          background-color: #45009d;
+        }
+
+        a.button-outline {
+          border: 2px solid #6700eb;
+          padding: 1rem 2rem;
+          color: #6700eb;
+          text-align: center;
+        }
+
+        a.button-outline:hover {
+          border-color: #45009d;
+          color: #45009d;
+        }
+
+        pre {
+          background: #fafafa;
+          border-radius: 5px;
+          padding: 0.75rem;
+        }
+        code {
+          font-size: 0.9rem;
+          font-family: Menlo, Monaco, Lucida Console, Liberation Mono, DejaVu Sans Mono,
+            Bitstream Vera Sans Mono, Courier New, monospace;
+        }
+
+        .grid {
+          display: flex;
+          align-items: center;
+          justify-content: center;
+          flex-wrap: wrap;
+
+          max-width: 800px;
+          margin-top: 3rem;
+        }
+
+        @media (max-width: 600px) {
+          .grid {
+            width: 100%;
+            flex-direction: column;
+          }
+        }
+      `}</style>
+
+      <style jsx global>{`
+        @import url("https://fonts.googleapis.com/css2?family=Libre+Franklin:wght@300;700&display=swap");
+
+        html,
+        body {
+          padding: 0;
+          margin: 0;
+          font-family: "Libre Franklin", -apple-system, BlinkMacSystemFont, Segoe UI, Roboto, Oxygen,
+            Ubuntu, Cantarell, Fira Sans, Droid Sans, Helvetica Neue, sans-serif;
+        }
+
+        * {
+          -webkit-font-smoothing: antialiased;
+          -moz-osx-font-smoothing: grayscale;
+          box-sizing: border-box;
+        }
+      `}</style>
+    </div>
+  </Layout>
+)
+
+export default Home

examples/auth/app/pages/ssr.tsx

@@ -0,0 +1,85 @@
+import * as React from "react"
+import {getSessionContext} from "@blitzjs/server"
+import {
+  ssrQuery,
+  useRouter,
+  GetServerSideProps,
+  PromiseReturnType,
+  ErrorComponent as ErrorPage,
+} from "blitz"
+import getUser from "app/users/queries/getUser"
+import logout from "app/auth/mutations/logout"
+import path from "path"
+
+type PageProps = {
+  user?: PromiseReturnType<typeof getUser>
+  error?: {
+    statusCode: number
+    message: string
+  }
+}
+
+export const getServerSideProps: GetServerSideProps<PageProps> = async ({req, res}) => {
+  // Ensure these files are not eliminated by trace-based tree-shaking (like Vercel)
+  // https://github.com/blitz-js/blitz/issues/794
+  path.resolve("next.config.js")
+  path.resolve("blitz.config.js")
+  path.resolve(".next/__db.js")
+  // End anti-tree-shaking
+
+  const session = await getSessionContext(req, res)
+  console.log("Session id:", session.userId)
+  try {
+    const user = await ssrQuery(
+      getUser,
+      {where: {id: Number(session.userId)}, select: {id: true}},
+      {res, req},
+    )
+    return {props: {user}}
+  } catch (error) {
+    if (error.name === "NotFoundError") {
+      res.statusCode = 404
+      res.end()
+      return {props: {}}
+    } else if (error.name === "AuthenticationError") {
+      res.writeHead(302, {location: "/login"})
+      res.end()
+      return {props: {}}
+    } else if (error.name === "AuthorizationError") {
+      return {
+        props: {
+          error: {
+            statusCode: error.statusCode,
+            message: "Sorry, you are not authorized to access this",
+          },
+        },
+      }
+    } else {
+      return {props: {error: {statusCode: error.statusCode || 500, message: error.message}}}
+    }
+  }
+}
+
+const Test: React.FC<PageProps> = ({user, error}: PageProps) => {
+  const router = useRouter()
+
+  if (error) {
+    return <ErrorPage statusCode={error.statusCode} title={error.message} />
+  }
+
+  return (
+    <div>
+      <div>Logged in user id: {user?.id}</div>
+      <button
+        onClick={async () => {
+          await logout()
+          router.push("/")
+        }}
+      >
+        Logout
+      </button>
+    </div>
+  )
+}
+
+export default Test

examples/auth/app/users/components/UserForm.tsx

@@ -0,0 +1,23 @@
+import React from "react"
+
+type UserFormProps = {
+  initialValues: any
+  onSubmit: React.FormEventHandler<HTMLFormElement>
+}
+
+const UserForm = ({initialValues, onSubmit}: UserFormProps) => {
+  return (
+    <form
+      onSubmit={(event) => {
+        event.preventDefault()
+        onSubmit(event)
+      }}
+    >
+      <div>Put your form fields here. But for now, just click submit</div>
+      <div>{JSON.stringify(initialValues)}</div>
+      <button>Submit</button>
+    </form>
+  )
+}
+
+export default UserForm

examples/auth/app/users/mutations/createUser.ts

@@ -0,0 +1,10 @@
+import db, {UserCreateArgs} from "db"
+
+type CreateUserInput = {
+  data: UserCreateArgs["data"]
+}
+export default async function createUser({data}: CreateUserInput, ctx: Record<any, any> = {}) {
+  const user = await db.user.create({data})
+
+  return user
+}

examples/auth/app/users/mutations/deleteUser.ts

@@ -0,0 +1,11 @@
+import db, {UserDeleteArgs} from "db"
+
+type DeleteUserInput = {
+  where: UserDeleteArgs["where"]
+}
+
+export default async function deleteUser({where}: DeleteUserInput, ctx: Record<any, any> = {}) {
+  const user = await db.user.delete({where})
+
+  return user
+}

examples/auth/app/users/mutations/trackView.ts

@@ -0,0 +1,9 @@
+import {SessionContext} from "blitz"
+
+export default async function trackView(_ = null, ctx: {session?: SessionContext} = {}) {
+  const currentViews = ctx.session!.publicData.views || 0
+  await ctx.session!.setPublicData({views: currentViews + 1})
+  await ctx.session!.setPrivateData({views: currentViews + 1})
+
+  return
+}

examples/auth/app/users/mutations/updateUser.ts

@@ -0,0 +1,18 @@
+import db, {UserUpdateArgs} from "db"
+
+type UpdateUserInput = {
+  where: UserUpdateArgs["where"]
+  data: UserUpdateArgs["data"]
+}
+
+export default async function updateUser(
+  {where, data}: UpdateUserInput,
+  ctx: Record<any, any> = {},
+) {
+  // Don't allow updating
+  delete data.id
+
+  const user = await db.user.update({where, data})
+
+  return user
+}

examples/auth/app/users/pages/users/[userId].tsx

@@ -0,0 +1,62 @@
+import React, {Suspense} from "react"
+import {Head, Link, useRouter, useQuery, useParam, BlitzPage} from "blitz"
+import getUser from "app/users/queries/getUser"
+import deleteUser from "app/users/mutations/deleteUser"
+
+export const User = () => {
+  const router = useRouter()
+  const userId = useParam("userId", "number")
+  const [user] = useQuery(getUser, {where: {id: userId}})
+
+  return (
+    <div>
+      <h1>User {user.id}</h1>
+      <pre>{JSON.stringify(user, null, 2)}</pre>
+
+      {
+        <Link href="/users/[userId]/edit" as={`/users/${user.id}/edit`}>
+          <a>Edit</a>
+        </Link>
+      }
+
+      <button
+        type="button"
+        onClick={async () => {
+          if (window.confirm("This will be deleted")) {
+            await deleteUser({where: {id: user.id}})
+            router.push("/users")
+          }
+        }}
+      >
+        Delete
+      </button>
+    </div>
+  )
+}
+
+const ShowUserPage: BlitzPage = () => {
+  return (
+    <div>
+      <Head>
+        <title>User</title>
+        <link rel="icon" href="/favicon.ico" />
+      </Head>
+
+      <main>
+        <p>
+          {
+            <Link href="/users">
+              <a>Users</a>
+            </Link>
+          }
+        </p>
+
+        <Suspense fallback={<div>Loading...</div>}>
+          <User />
+        </Suspense>
+      </main>
+    </div>
+  )
+}
+
+export default ShowUserPage

examples/auth/app/users/pages/users/[userId]/edit.tsx

@@ -0,0 +1,63 @@
+import React, {Suspense} from "react"
+import {Head, Link, useRouter, useQuery, useParam, BlitzPage} from "blitz"
+import getUser from "app/users/queries/getUser"
+import updateUser from "app/users/mutations/updateUser"
+import UserForm from "app/users/components/UserForm"
+
+export const EditUser = () => {
+  const router = useRouter()
+  const userId = useParam("userId", "number")
+  const [user, {mutate}] = useQuery(getUser, {where: {id: userId}})
+
+  return (
+    <div>
+      <h1>Edit User {user.id}</h1>
+      <pre>{JSON.stringify(user)}</pre>
+
+      <UserForm
+        initialValues={user}
+        onSubmit={async () => {
+          try {
+            const updated = await updateUser({
+              where: {id: user.id},
+              data: {name: "MyNewName"},
+            })
+            mutate(updated)
+            alert("Success!" + JSON.stringify(updated))
+            router.push("/users/[userId]", `/users/${updated.id}`)
+          } catch (error) {
+            console.log(error)
+            alert("Error creating user " + JSON.stringify(error, null, 2))
+          }
+        }}
+      />
+    </div>
+  )
+}
+
+const EditUserPage: BlitzPage = () => {
+  return (
+    <div>
+      <Head>
+        <title>Edit User</title>
+        <link rel="icon" href="/favicon.ico" />
+      </Head>
+
+      <main>
+        <Suspense fallback={<div>Loading...</div>}>
+          <EditUser />
+        </Suspense>
+
+        <p>
+          {
+            <Link href="/users">
+              <a>Users</a>
+            </Link>
+          }
+        </p>
+      </main>
+    </div>
+  )
+}
+
+export default EditUserPage

examples/auth/app/users/pages/users/index.tsx

@@ -0,0 +1,49 @@
+import React, {Suspense} from "react"
+import {Head, Link, useQuery, BlitzPage} from "blitz"
+import getUsers from "app/users/queries/getUsers"
+import Layout from "app/layouts/Layout"
+
+export const UsersList = () => {
+  const [users] = useQuery(getUsers, {orderBy: {id: "desc"}})
+
+  return (
+    <ul>
+      {users?.map((user) => (
+        <li key={user.id}>
+          <Link href="/users/[userId]" as={`/users/${user.id}`}>
+            <a>{user.email}</a>
+          </Link>
+        </li>
+      ))}
+    </ul>
+  )
+}
+
+const UsersPage: BlitzPage = () => {
+  return (
+    <Layout>
+      <Head>
+        <title>Users</title>
+        <link rel="icon" href="/favicon.ico" />
+      </Head>
+
+      <main>
+        <h1>Users</h1>
+
+        <p>
+          {
+            <Link href="/users/new">
+              <a>Create User</a>
+            </Link>
+          }
+        </p>
+
+        <Suspense fallback={<div>Loading...</div>}>
+          <UsersList />
+        </Suspense>
+      </main>
+    </Layout>
+  )
+}
+
+export default UsersPage

examples/auth/app/users/pages/users/new.tsx

@@ -0,0 +1,44 @@
+import React from "react"
+import {Head, Link, useRouter, BlitzPage} from "blitz"
+import createUser from "app/users/mutations/createUser"
+import UserForm from "app/users/components/UserForm"
+
+const NewUserPage: BlitzPage = () => {
+  const router = useRouter()
+
+  return (
+    <div>
+      <Head>
+        <title>New User</title>
+        <link rel="icon" href="/favicon.ico" />
+      </Head>
+
+      <main>
+        <h1>Create New User </h1>
+
+        <UserForm
+          initialValues={{}}
+          onSubmit={async () => {
+            try {
+              const user = await createUser({data: {name: "MyName"}})
+              alert("Success!" + JSON.stringify(user))
+              router.push("/users/[userId]", `/users/${user.id}`)
+            } catch (error) {
+              alert("Error creating user " + JSON.stringify(error, null, 2))
+            }
+          }}
+        />
+
+        <p>
+          {
+            <Link href="/users">
+              <a>Users</a>
+            </Link>
+          }
+        </p>
+      </main>
+    </div>
+  )
+}
+
+export default NewUserPage

examples/auth/app/users/queries/getUser.ts

@@ -0,0 +1,22 @@
+import db, {FindOneUserArgs} from "db"
+import {SessionContext, NotFoundError} from "blitz"
+
+type GetUserInput = {
+  where: FindOneUserArgs["where"]
+  select?: FindOneUserArgs["select"]
+  // Only available if a model relationship exists
+  // include?: FindOneUserArgs['include']
+}
+
+export default async function getUser(
+  {where, select}: GetUserInput,
+  ctx: {session?: SessionContext} = {},
+) {
+  ctx.session?.authorize(["admin", "user"])
+
+  const user = await db.user.findOne({where, select})
+
+  if (!user) throw new NotFoundError(`User with id ${where.id} does not exist`)
+
+  return user
+}

examples/auth/app/users/queries/getUsers.ts

@@ -0,0 +1,29 @@
+import db, {FindManyUserArgs} from "db"
+import {SessionContext} from "blitz"
+
+type GetUsersInput = {
+  where?: FindManyUserArgs["where"]
+  orderBy?: FindManyUserArgs["orderBy"]
+  cursor?: FindManyUserArgs["cursor"]
+  take?: FindManyUserArgs["take"]
+  skip?: FindManyUserArgs["skip"]
+  // Only available if a model relationship exists
+  // include?: FindManyUserArgs['include']
+}
+
+export default async function getUsers(
+  {where, orderBy, cursor, take, skip}: GetUsersInput,
+  ctx: {session?: SessionContext} = {},
+) {
+  ctx.session?.authorize(["admin"])
+
+  const users = await db.user.findMany({
+    where,
+    orderBy,
+    cursor,
+    take,
+    skip,
+  })
+
+  return users
+}

examples/auth/blitz.config.js

@@ -0,0 +1,25 @@
+const {sessionMiddleware, unstable_simpleRolesIsAuthorized} = require("@blitzjs/server")
+const withBundleAnalyzer = require("@next/bundle-analyzer")({
+  enabled: process.env.ANALYZE === "true",
+})
+
+module.exports = withBundleAnalyzer({
+  middleware: [
+    sessionMiddleware({
+      unstable_isAuthorized: unstable_simpleRolesIsAuthorized,
+    }),
+  ],
+  /*
+  webpack: (config, {buildId, dev, isServer, defaultLoaders, webpack}) => {
+    // Note: we provide webpack above so you should not `require` it
+    // Perform customizations to webpack config
+    // Important: return the modified config
+    return config
+  },
+  webpackDevMiddleware: (config) => {
+    // Perform customizations to webpack dev middleware config
+    // Important: return the modified config
+    return config
+  },
+  */
+})

examples/auth/cypress.json

@@ -0,0 +1,5 @@
+{
+  "baseUrl": "http://localhost:3099",
+  "defaultCommandTimeout": 10000,
+  "video": false
+}

examples/auth/cypress/fixtures/example.json

@@ -0,0 +1,5 @@
+{
+  "name": "Using fixtures to represent data",
+  "email": "hello@cypress.io",
+  "body": "Fixtures are a great way to mock data for responses to routes"
+}

examples/auth/cypress/index.d.ts

@@ -0,0 +1,8 @@
+/// <reference types="Cypress" />
+/// <reference types="@cypress/skip-test" />
+
+declare namespace Cypress {
+  interface Chainable {
+    signup(user: {email: string; password: string}): void
+  }
+}

examples/auth/cypress/integration/index.test.ts

@@ -0,0 +1,69 @@
+import {createRandomUser} from "../support/helpers"
+
+describe("index page", () => {
+  beforeEach(() => {
+    cy.visit("/")
+  })
+
+  it("goes to the signup page", () => {
+    cy.contains("a", "Sign Up").click()
+    cy.location("pathname").should("equal", "/signup")
+  })
+
+  it("goes to the login page", () => {
+    cy.contains("a", "Log In").click()
+    cy.location("pathname").should("equal", "/login")
+  })
+
+  it("allows the user to signup", () => {
+    const user = createRandomUser()
+
+    cy.signup(user)
+
+    cy.location("pathname").should("equal", "/")
+    cy.contains("button", "Logout")
+  })
+
+  it("allows the user to log in", () => {
+    const user = createRandomUser()
+
+    cy.signup(user)
+
+    cy.contains("button", "Logout").click()
+    cy.contains("a", "Log In").click()
+
+    cy.contains("Email").find("input").type(user.email)
+    cy.contains("Password").find("input").type(user.password)
+    cy.contains("button", "Log In").click()
+
+    cy.location("pathname").should("equal", "/")
+    cy.contains("button", "Logout")
+  })
+
+  it("allows the user to logout", () => {
+    const user = createRandomUser()
+
+    cy.signup(user)
+
+    cy.contains("button", "Logout").click()
+
+    cy.location("pathname").should("equal", "/")
+    cy.contains("a", "Log In")
+  })
+
+  it("tracks anonymous sessions", () => {
+    // TODO - why does this fail on windows??
+    cy.skipOn("windows")
+    const user = createRandomUser()
+
+    cy.contains("button", "Track view").click()
+    cy.contains("button", "Track view").click()
+    cy.contains('"views": 2')
+
+    cy.signup(user)
+
+    cy.contains('"views": 2')
+  })
+})
+
+export {}

examples/auth/cypress/plugins/index.ts

@@ -0,0 +1,21 @@
+/// <reference types="cypress" />
+// ***********************************************************
+// This example plugins/index.js can be used to load plugins
+//
+// You can change the location of this file or turn off loading
+// the plugins file with the 'pluginsFile' configuration option.
+//
+// You can read more here:
+// https://on.cypress.io/plugins-guide
+// ***********************************************************
+
+// This function is called when a project is opened or re-opened (e.g. due to
+// the project's config changing)
+
+/**
+ * @type {Cypress.PluginConfig}
+ */
+module.exports = (on, config) => {
+  // `on` is used to hook into various events Cypress emits
+  // `config` is the resolved Cypress config
+}

examples/auth/cypress/support/commands.ts

@@ -0,0 +1,19 @@
+// ***********************************************
+// This example commands.js shows you how to
+// create various custom commands and overwrite
+// existing commands.
+//
+// For more comprehensive examples of custom
+// commands please read more here:
+// https://on.cypress.io/custom-commands
+// ***********************************************
+//
+//
+
+Cypress.Commands.add("signup", ({email, password}) => {
+  cy.contains("a", "Sign Up").click()
+
+  cy.contains("Email").find("input").type(email)
+  cy.contains("Password").find("input").type(password)
+  cy.contains("button", "Create Account").click()
+})

examples/auth/cypress/support/helpers.ts

@@ -0,0 +1,7 @@
+export const createRandomUser = () => {
+  const random = Math.round(Math.random() * 100000).toString()
+  const email = `test_${random}@example.com`
+  const password = `password_${random}`
+
+  return {email, password}
+}

examples/auth/cypress/support/index.ts

@@ -0,0 +1,26 @@
+// ***********************************************************
+// This example support/index.js is processed and
+// loaded automatically before your test files.
+//
+// This is a great place to put global configuration and
+// behavior that modifies Cypress.
+//
+// You can change the location of this file or turn off
+// automatically serving support files with the
+// 'supportFile' configuration option.
+//
+// You can read more here:
+// https://on.cypress.io/configuration
+// ***********************************************************
+
+// Import commands.js using ES2015 syntax:
+import "./commands"
+
+// Alternatively you can use CommonJS syntax:
+// require('./commands')
+
+Cypress.Screenshot.defaults({
+  screenshotOnRunFailure: false,
+})
+
+require("@cypress/skip-test/support")

examples/auth/db/index.ts

@@ -0,0 +1,15 @@
+import {PrismaClient} from "@prisma/client"
+export * from "@prisma/client"
+
+let prisma: PrismaClient
+
+if (process.env.NODE_ENV === "production") {
+  prisma = new PrismaClient()
+} else {
+  // Ensure the prisma instance is re-used during hot-reloading
+  // Otherwise, a new client will be created on every reload
+  global["prisma"] = global["prisma"] || new PrismaClient()
+  prisma = global["prisma"]
+}
+
+export default prisma

examples/auth/db/migrations/20200704211726/README.md

@@ -0,0 +1,82 @@
+# Migration `20200704211726`
+
+This migration has been generated by Brandon Bayer at 7/4/2020, 9:17:26 PM.
+You can check out the [state of the schema](./schema.prisma) after the migration.
+
+## Database Steps
+
+```sql
+PRAGMA foreign_keys=OFF;
+
+CREATE TABLE "quaint"."User" (
+"createdAt" DATE NOT NULL DEFAULT CURRENT_TIMESTAMP ,"email" TEXT NOT NULL  ,"hashedPassword" TEXT NOT NULL  ,"id" INTEGER NOT NULL  PRIMARY KEY AUTOINCREMENT,"name" TEXT   ,"role" TEXT NOT NULL  ,"updatedAt" DATE NOT NULL  )
+
+CREATE TABLE "quaint"."Session" (
+"antiCSRFToken" TEXT   ,"createdAt" DATE NOT NULL DEFAULT CURRENT_TIMESTAMP ,"expiresAt" DATE   ,"handle" TEXT NOT NULL  ,"hashedSessionToken" TEXT   ,"id" INTEGER NOT NULL  PRIMARY KEY AUTOINCREMENT,"privateData" TEXT   ,"publicData" TEXT   ,"updatedAt" DATE NOT NULL  ,"userId" INTEGER   ,FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE SET NULL ON UPDATE CASCADE)
+
+CREATE UNIQUE INDEX "quaint"."User.email" ON "User"("email")
+
+CREATE UNIQUE INDEX "quaint"."Session.handle" ON "Session"("handle")
+
+PRAGMA "quaint".foreign_key_check;
+
+PRAGMA foreign_keys=ON;
+```
+
+## Changes
+
+```diff
+diff --git schema.prisma schema.prisma
+migration ..20200704211726
+--- datamodel.dml
++++ datamodel.dml
+@@ -1,0 +1,46 @@
++// This is your Prisma schema file,
++// learn more about it in the docs: https://pris.ly/d/prisma-schema
++
++datasource sqlite {
++  provider = "sqlite"
++  url = "***"
++}
++
++// SQLite is easy to start with, but if you use Postgres in production
++// you should also use it in development with the following:
++//datasource postgresql {
++//  provider = "postgresql"
++//  url = "***"
++//}
++
++generator client {
++  provider = "prisma-client-js"
++}
++
++
++// --------------------------------------
++
++model User {
++  id        Int      @default(autoincrement()) @id
++  createdAt DateTime @default(now())
++  updatedAt DateTime @updatedAt
++  name      String?
++  email     String   @unique
++  hashedPassword String
++  role      String
++  sessions  Session[]
++}
++
++model Session {
++  id                 Int      @default(autoincrement()) @id
++  createdAt          DateTime @default(now())
++  updatedAt          DateTime @updatedAt
++  expiresAt          DateTime?
++  handle             String   @unique
++  user               User?     @relation(fields: [userId], references: [id])
++  userId             Int?
++  hashedSessionToken String?
++  antiCSRFToken      String?
++  publicData         String?
++  privateData        String?
++}
+```
+
+

examples/auth/db/migrations/20200704211726/schema.prisma

@@ -0,0 +1,46 @@
+// This is your Prisma schema file,
+// learn more about it in the docs: https://pris.ly/d/prisma-schema
+
+datasource sqlite {
+  provider = "sqlite"
+  url = "***"
+}
+
+// SQLite is easy to start with, but if you use Postgres in production
+// you should also use it in development with the following:
+//datasource postgresql {
+//  provider = "postgresql"
+//  url = "***"
+//}
+
+generator client {
+  provider = "prisma-client-js"
+}
+
+
+// --------------------------------------
+
+model User {
+  id        Int      @default(autoincrement()) @id
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+  name      String?
+  email     String   @unique
+  hashedPassword String
+  role      String
+  sessions  Session[]
+}
+
+model Session {
+  id                 Int      @default(autoincrement()) @id
+  createdAt          DateTime @default(now())
+  updatedAt          DateTime @updatedAt
+  expiresAt          DateTime?
+  handle             String   @unique
+  user               User?     @relation(fields: [userId], references: [id])
+  userId             Int?
+  hashedSessionToken String?
+  antiCSRFToken      String?
+  publicData         String?
+  privateData        String?
+}

examples/auth/db/migrations/20200704211726/steps.json

@@ -0,0 +1,373 @@
+{
+  "version": "0.3.14-fixed",
+  "steps": [
+    {
+      "tag": "CreateSource",
+      "source": "sqlite"
+    },
+    {
+      "tag": "CreateArgument",
+      "location": {
+        "tag": "Source",
+        "source": "sqlite"
+      },
+      "argument": "provider",
+      "value": "\"sqlite\""
+    },
+    {
+      "tag": "CreateArgument",
+      "location": {
+        "tag": "Source",
+        "source": "sqlite"
+      },
+      "argument": "url",
+      "value": "\"file:./db.sqlite\""
+    },
+    {
+      "tag": "CreateModel",
+      "model": "User"
+    },
+    {
+      "tag": "CreateField",
+      "model": "User",
+      "field": "id",
+      "type": "Int",
+      "arity": "Required"
+    },
+    {
+      "tag": "CreateDirective",
+      "location": {
+        "path": {
+          "tag": "Field",
+          "model": "User",
+          "field": "id"
+        },
+        "directive": "default"
+      }
+    },
+    {
+      "tag": "CreateArgument",
+      "location": {
+        "tag": "Directive",
+        "path": {
+          "tag": "Field",
+          "model": "User",
+          "field": "id"
+        },
+        "directive": "default"
+      },
+      "argument": "",
+      "value": "autoincrement()"
+    },
+    {
+      "tag": "CreateDirective",
+      "location": {
+        "path": {
+          "tag": "Field",
+          "model": "User",
+          "field": "id"
+        },
+        "directive": "id"
+      }
+    },
+    {
+      "tag": "CreateField",
+      "model": "User",
+      "field": "createdAt",
+      "type": "DateTime",
+      "arity": "Required"
+    },
+    {
+      "tag": "CreateDirective",
+      "location": {
+        "path": {
+          "tag": "Field",
+          "model": "User",
+          "field": "createdAt"
+        },
+        "directive": "default"
+      }
+    },
+    {
+      "tag": "CreateArgument",
+      "location": {
+        "tag": "Directive",
+        "path": {
+          "tag": "Field",
+          "model": "User",
+          "field": "createdAt"
+        },
+        "directive": "default"
+      },
+      "argument": "",
+      "value": "now()"
+    },
+    {
+      "tag": "CreateField",
+      "model": "User",
+      "field": "updatedAt",
+      "type": "DateTime",
+      "arity": "Required"
+    },
+    {
+      "tag": "CreateDirective",
+      "location": {
+        "path": {
+          "tag": "Field",
+          "model": "User",
+          "field": "updatedAt"
+        },
+        "directive": "updatedAt"
+      }
+    },
+    {
+      "tag": "CreateField",
+      "model": "User",
+      "field": "name",
+      "type": "String",
+      "arity": "Optional"
+    },
+    {
+      "tag": "CreateField",
+      "model": "User",
+      "field": "email",
+      "type": "String",
+      "arity": "Required"
+    },
+    {
+      "tag": "CreateDirective",
+      "location": {
+        "path": {
+          "tag": "Field",
+          "model": "User",
+          "field": "email"
+        },
+        "directive": "unique"
+      }
+    },
+    {
+      "tag": "CreateField",
+      "model": "User",
+      "field": "hashedPassword",
+      "type": "String",
+      "arity": "Required"
+    },
+    {
+      "tag": "CreateField",
+      "model": "User",
+      "field": "role",
+      "type": "String",
+      "arity": "Required"
+    },
+    {
+      "tag": "CreateField",
+      "model": "User",
+      "field": "sessions",
+      "type": "Session",
+      "arity": "List"
+    },
+    {
+      "tag": "CreateModel",
+      "model": "Session"
+    },
+    {
+      "tag": "CreateField",
+      "model": "Session",
+      "field": "id",
+      "type": "Int",
+      "arity": "Required"
+    },
+    {
+      "tag": "CreateDirective",
+      "location": {
+        "path": {
+          "tag": "Field",
+          "model": "Session",
+          "field": "id"
+        },
+        "directive": "default"
+      }
+    },
+    {
+      "tag": "CreateArgument",
+      "location": {
+        "tag": "Directive",
+        "path": {
+          "tag": "Field",
+          "model": "Session",
+          "field": "id"
+        },
+        "directive": "default"
+      },
+      "argument": "",
+      "value": "autoincrement()"
+    },
+    {
+      "tag": "CreateDirective",
+      "location": {
+        "path": {
+          "tag": "Field",
+          "model": "Session",
+          "field": "id"
+        },
+        "directive": "id"
+      }
+    },
+    {
+      "tag": "CreateField",
+      "model": "Session",
+      "field": "createdAt",
+      "type": "DateTime",
+      "arity": "Required"
+    },
+    {
+      "tag": "CreateDirective",
+      "location": {
+        "path": {
+          "tag": "Field",
+          "model": "Session",
+          "field": "createdAt"
+        },
+        "directive": "default"
+      }
+    },
+    {
+      "tag": "CreateArgument",
+      "location": {
+        "tag": "Directive",
+        "path": {
+          "tag": "Field",
+          "model": "Session",
+          "field": "createdAt"
+        },
+        "directive": "default"
+      },
+      "argument": "",
+      "value": "now()"
+    },
+    {
+      "tag": "CreateField",
+      "model": "Session",
+      "field": "updatedAt",
+      "type": "DateTime",
+      "arity": "Required"
+    },
+    {
+      "tag": "CreateDirective",
+      "location": {
+        "path": {
+          "tag": "Field",
+          "model": "Session",
+          "field": "updatedAt"
+        },
+        "directive": "updatedAt"
+      }
+    },
+    {
+      "tag": "CreateField",
+      "model": "Session",
+      "field": "expiresAt",
+      "type": "DateTime",
+      "arity": "Optional"
+    },
+    {
+      "tag": "CreateField",
+      "model": "Session",
+      "field": "handle",
+      "type": "String",
+      "arity": "Required"
+    },
+    {
+      "tag": "CreateDirective",
+      "location": {
+        "path": {
+          "tag": "Field",
+          "model": "Session",
+          "field": "handle"
+        },
+        "directive": "unique"
+      }
+    },
+    {
+      "tag": "CreateField",
+      "model": "Session",
+      "field": "user",
+      "type": "User",
+      "arity": "Optional"
+    },
+    {
+      "tag": "CreateDirective",
+      "location": {
+        "path": {
+          "tag": "Field",
+          "model": "Session",
+          "field": "user"
+        },
+        "directive": "relation"
+      }
+    },
+    {
+      "tag": "CreateArgument",
+      "location": {
+        "tag": "Directive",
+        "path": {
+          "tag": "Field",
+          "model": "Session",
+          "field": "user"
+        },
+        "directive": "relation"
+      },
+      "argument": "fields",
+      "value": "[userId]"
+    },
+    {
+      "tag": "CreateArgument",
+      "location": {
+        "tag": "Directive",
+        "path": {
+          "tag": "Field",
+          "model": "Session",
+          "field": "user"
+        },
+        "directive": "relation"
+      },
+      "argument": "references",
+      "value": "[id]"
+    },
+    {
+      "tag": "CreateField",
+      "model": "Session",
+      "field": "userId",
+      "type": "Int",
+      "arity": "Optional"
+    },
+    {
+      "tag": "CreateField",
+      "model": "Session",
+      "field": "hashedSessionToken",
+      "type": "String",
+      "arity": "Optional"
+    },
+    {
+      "tag": "CreateField",
+      "model": "Session",
+      "field": "antiCSRFToken",
+      "type": "String",
+      "arity": "Optional"
+    },
+    {
+      "tag": "CreateField",
+      "model": "Session",
+      "field": "publicData",
+      "type": "String",
+      "arity": "Optional"
+    },
+    {
+      "tag": "CreateField",
+      "model": "Session",
+      "field": "privateData",
+      "type": "String",
+      "arity": "Optional"
+    }
+  ]
+}

examples/auth/db/migrations/20200711145940/README.md

@@ -0,0 +1,66 @@
+# Migration `20200711145940`
+
+This migration has been generated by Brandon Bayer at 7/11/2020, 2:59:40 PM.
+You can check out the [state of the schema](./schema.prisma) after the migration.
+
+## Database Steps
+
+```sql
+PRAGMA foreign_keys=OFF;
+
+CREATE TABLE "quaint"."new_User" (
+"createdAt" DATE NOT NULL DEFAULT CURRENT_TIMESTAMP ,"email" TEXT NOT NULL  ,"hashedPassword" TEXT   ,"id" INTEGER NOT NULL  PRIMARY KEY AUTOINCREMENT,"name" TEXT   ,"role" TEXT NOT NULL DEFAULT 'user' ,"updatedAt" DATE NOT NULL  )
+
+INSERT INTO "quaint"."new_User" ("createdAt", "email", "hashedPassword", "id", "name", "role", "updatedAt") SELECT "createdAt", "email", "hashedPassword", "id", "name", "role", "updatedAt" FROM "quaint"."User"
+
+PRAGMA foreign_keys=off;
+DROP TABLE "quaint"."User";;
+PRAGMA foreign_keys=on
+
+ALTER TABLE "quaint"."new_User" RENAME TO "User";
+
+CREATE UNIQUE INDEX "quaint"."User.email" ON "User"("email")
+
+PRAGMA "quaint".foreign_key_check;
+
+PRAGMA foreign_keys=ON;
+```
+
+## Changes
+
+```diff
+diff --git schema.prisma schema.prisma
+migration 20200704211726..20200711145940
+--- datamodel.dml
++++ datamodel.dml
+@@ -2,16 +2,16 @@
+ // learn more about it in the docs: https://pris.ly/d/prisma-schema
+ datasource sqlite {
+   provider = "sqlite"
+-  url = "***"
++  url = "***"
+ }
+ // SQLite is easy to start with, but if you use Postgres in production
+ // you should also use it in development with the following:
+ //datasource postgresql {
+ //  provider = "postgresql"
+-//  url = "***"
++//  url = "***"
+ //}
+ generator client {
+   provider = "prisma-client-js"
+@@ -25,10 +25,10 @@
+   createdAt DateTime @default(now())
+   updatedAt DateTime @updatedAt
+   name      String?
+   email     String   @unique
+-  hashedPassword String
+-  role      String
++  hashedPassword String?
++  role      String   @default("user")
+   sessions  Session[]
+ }
+ model Session {
+```
+
+

examples/auth/db/migrations/20200711145940/schema.prisma

@@ -0,0 +1,46 @@
+// This is your Prisma schema file,
+// learn more about it in the docs: https://pris.ly/d/prisma-schema
+
+datasource sqlite {
+  provider = "sqlite"
+  url = "***"
+}
+
+// SQLite is easy to start with, but if you use Postgres in production
+// you should also use it in development with the following:
+//datasource postgresql {
+//  provider = "postgresql"
+//  url = "***"
+//}
+
+generator client {
+  provider = "prisma-client-js"
+}
+
+
+// --------------------------------------
+
+model User {
+  id        Int      @default(autoincrement()) @id
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+  name      String?
+  email     String   @unique
+  hashedPassword String?
+  role      String   @default("user")
+  sessions  Session[]
+}
+
+model Session {
+  id                 Int      @default(autoincrement()) @id
+  createdAt          DateTime @default(now())
+  updatedAt          DateTime @updatedAt
+  expiresAt          DateTime?
+  handle             String   @unique
+  user               User?     @relation(fields: [userId], references: [id])
+  userId             Int?
+  hashedSessionToken String?
+  antiCSRFToken      String?
+  publicData         String?
+  privateData        String?
+}

examples/auth/db/migrations/20200711145940/steps.json

@@ -0,0 +1,36 @@
+{
+  "version": "0.3.14-fixed",
+  "steps": [
+    {
+      "tag": "UpdateField",
+      "model": "User",
+      "field": "hashedPassword",
+      "arity": "Optional"
+    },
+    {
+      "tag": "CreateDirective",
+      "location": {
+        "path": {
+          "tag": "Field",
+          "model": "User",
+          "field": "role"
+        },
+        "directive": "default"
+      }
+    },
+    {
+      "tag": "CreateArgument",
+      "location": {
+        "tag": "Directive",
+        "path": {
+          "tag": "Field",
+          "model": "User",
+          "field": "role"
+        },
+        "directive": "default"
+      },
+      "argument": "",
+      "value": "\"user\""
+    }
+  ]
+}

examples/auth/db/migrations/migrate.lock

@@ -0,0 +1,4 @@
+# Prisma Migrate lockfile v1
+
+20200704211726
+20200711145940

examples/auth/db/schema.prisma

@@ -0,0 +1,45 @@
+// This is your Prisma schema file,
+// learn more about it in the docs: https://pris.ly/d/prisma-schema
+
+datasource sqlite {
+  provider = "sqlite"
+  url      = "file:./db.sqlite"
+}
+
+// SQLite is easy to start with, but if you use Postgres in production
+// you should also use it in development with the following:
+//datasource postgresql {
+//  provider = "postgresql"
+//  url      = env("DATABASE_URL")
+//}
+
+generator client {
+  provider = "prisma-client-js"
+}
+
+// --------------------------------------
+
+model User {
+  id             Int       @default(autoincrement()) @id
+  createdAt      DateTime  @default(now())
+  updatedAt      DateTime  @updatedAt
+  name           String?
+  email          String    @unique
+  hashedPassword String?
+  role           String    @default("user")
+  sessions       Session[]
+}
+
+model Session {
+  id                 Int       @default(autoincrement()) @id
+  createdAt          DateTime  @default(now())
+  updatedAt          DateTime  @updatedAt
+  expiresAt          DateTime?
+  handle             String    @unique
+  user               User?     @relation(fields: [userId], references: [id])
+  userId             Int?
+  hashedSessionToken String?
+  antiCSRFToken      String?
+  publicData         String?
+  privateData        String?
+}

examples/auth/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@examples/auth",
+  "version": "0.17.1-canary.1",
+  "scripts": {
+    "start": "blitz start",
+    "studio": "blitz db studio",
+    "build": "blitz build",
+    "lint": "eslint --ignore-path .gitignore --ext .js,.ts,.tsx .",
+    "analyze": "cross-env ANALYZE=true blitz build",
+    "cy:open": "cypress open",
+    "cy:run": "cypress run --browser chrome",
+    "test:start": "blitz db migrate && blitz start --production -p 3099",
+    "test": "cross-env NODE_ENV=test start-server-and-test test:start http://localhost:3099 cy:run"
+  },
+  "browserslist": [
+    "defaults"
+  ],
+  "prettier": {
+    "semi": false,
+    "printWidth": 100,
+    "bracketSpacing": false,
+    "trailingComma": "all"
+  },
+  "husky": {
+    "hooks": {
+      "pre-commit": "lint-staged && pretty-quick --staged",
+      "pre-push": "blitz test"
+    }
+  },
+  "lint-staged": {
+    "*.{js,ts,tsx}": [
+      "eslint --fix"
+    ]
+  },
+  "dependencies": {
+    "@prisma/cli": "2.1.0",
+    "@prisma/client": "2.1.0",
+    "blitz": "0.17.1-canary.1",
+    "final-form": "4.20.1",
+    "passport-github2": "0.1.11",
+    "passport-twitter": "1.0.4",
+    "react": "0.0.0-experimental-33c3af284",
+    "react-dom": "0.0.0-experimental-33c3af284",
+    "react-error-boundary": "2.3.1",
+    "react-final-form": "6.5.1",
+    "secure-password": "4.0.0",
+    "zod": "1.10.0"
+  },
+  "devDependencies": {
+    "@cypress/skip-test": "2.5.0",
+    "@next/bundle-analyzer": "latest",
+    "@types/passport-github2": "1.2.4",
+    "@types/passport-twitter": "1.0.36",
+    "@types/react": "16.9.38",
+    "@types/secure-password": "3.1.0",
+    "@typescript-eslint/eslint-plugin": "2.34.1-alpha.2",
+    "@typescript-eslint/parser": "2.34.1-alpha.2",
+    "babel-eslint": "10.1.0",
+    "cross-env": "latest",
+    "cypress": "4.11.0",
+    "eslint": "6.8.0",
+    "eslint-config-react-app": "5.2.1",
+    "eslint-plugin-cypress": "2.11.1",
+    "eslint-plugin-flowtype": "4.7.0",
+    "eslint-plugin-import": "2.21.2",
+    "eslint-plugin-jsx-a11y": "6.3.1",
+    "eslint-plugin-react": "7.20.0",
+    "eslint-plugin-react-hooks": "3.0.0",
+    "husky": "4.2.5",
+    "lint-staged": "10.2.11",
+    "prettier": "2.0.5",
+    "pretty-quick": "2.0.1",
+    "start-server-and-test": "1.11.2",
+    "typescript": "3.9.5"
+  },
+  "private": true
+}

examples/auth/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "es5",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "baseUrl": "./",
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": false,
+    "strictNullChecks": true,
+    "forceConsistentCasingInFileNames": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "node",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve"
+  },
+  "exclude": ["node_modules"],
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx"]
+}

examples/no-prisma/.babelrc.js

@@ -0,0 +1,4 @@
+module.exports = {
+  presets: ["next/babel"],
+  plugins: [],
+}

examples/no-prisma/.eslintrc.js

@@ -0,0 +1,10 @@
+module.exports = {
+  extends: ["react-app", "plugin:jsx-a11y/recommended"],
+  plugins: ["jsx-a11y"],
+  rules: {
+    "import/no-anonymous-default-export": "error",
+    "import/no-webpack-loader-syntax": "off",
+    "react/react-in-jsx-scope": "off", // React is always in scope with Blitz
+    "jsx-a11y/anchor-is-valid": "off", //Doesn't play well with Blitz/Next <Link> usage
+  },
+}

examples/no-prisma/.gitignore

@@ -0,0 +1,55 @@
+# dependencies
+node_modules
+.yarn/cache
+.yarn/unplugged
+.yarn/build-state.yml
+.pnp.*
+.npm
+web_modules/
+
+# blitz
+/.blitz/
+/.next/
+*.sqlite
+.now
+.blitz-console-history
+blitz-log.log
+
+# misc
+.DS_Store
+
+# local env files
+.env
+.envrc
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# Logs
+logs
+*.log
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Testing
+coverage
+*.lcov
+.nyc_output
+lib-cov
+
+# Caches
+*.tsbuildinfo
+.eslintcache
+.node_repl_history
+.yarn-integrity
+
+# Serverless directories
+.serverless/
+
+# Stores VSCode versions used for testing VSCode extensions
+.vscode-test

examples/no-prisma/.npmrc

@@ -0,0 +1 @@
+save-exact=true

examples/no-prisma/.prettierignore

@@ -0,0 +1,5 @@
+.gitkeep
+.env*
+*.ico
+*.lock
+db/migrations

examples/no-prisma/README.md

@@ -0,0 +1,26 @@
+# no-prisma
+
+## Getting Started
+
+1. Add this code to db/schema.prisma:
+
+```
+model Project {
+  id      Int      @default(autoincrement()) @id
+  name    String
+}
+```
+
+2. DB migrate
+
+```
+blitz db migrate
+```
+
+3. Start the dev server
+
+```
+blitz start
+```
+
+Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.

examples/no-prisma/app/mutations/addGIF.ts

@@ -0,0 +1,6 @@
+import db from "db"
+import { GIFModel } from "db/GIFModel"
+
+export default async function addGIF(url: string) {
+  await db<GIFModel>("gifs").insert({ url })
+}

examples/no-prisma/app/mutations/addRating.ts

@@ -0,0 +1,6 @@
+import RatingModel from "db/RatingModel"
+import db from "db"
+
+export default async function addRating(rating: RatingModel) {
+  await db<RatingModel>("ratings").insert(rating)
+}

examples/no-prisma/app/pages/_app.tsx

@@ -0,0 +1,5 @@
+import { AppProps } from "blitz"
+
+export default function MyApp({ Component, pageProps }: AppProps) {
+  return <Component {...pageProps} />
+}

examples/no-prisma/app/pages/_document.tsx

@@ -0,0 +1,23 @@
+import { Document, Html, DocumentHead, Main, BlitzScript /*DocumentContext*/ } from "blitz"
+
+class MyDocument extends Document {
+  // Only uncomment if you need to customize this behaviour
+  // static async getInitialProps(ctx: DocumentContext) {
+  //   const initialProps = await Document.getInitialProps(ctx)
+  //   return {...initialProps}
+  // }
+
+  render() {
+    return (
+      <Html lang="en">
+        <DocumentHead />
+        <body>
+          <Main />
+          <BlitzScript />
+        </body>
+      </Html>
+    )
+  }
+}
+
+export default MyDocument

examples/no-prisma/app/pages/index.module.css

@@ -0,0 +1,32 @@
+.main {
+  margin: 10px;
+}
+
+.gif_list {
+  list-style-type: none;
+  margin: 0;
+  padding: 0;
+}
+
+.gif_list > li {
+  border: solid black 1px;
+  border-radius: 10px;
+  padding: 10px;
+  margin: 20px;
+  width: fit-content;
+}
+
+.gif_list > li > img {
+  border-radius: 10px;
+  margin-bottom: 10px;
+  display: block;
+}
+
+.gif_list > li > span {
+  margin-left: 5px;
+  margin-right: 10px;
+}
+
+.gif_list > li > span > select {
+  float: right;
+}