[examples/openspending][xl]: add table preview to showcase page, minor fixes

[site][xs] - add components tab in navbar
Dev how-to pages (#890 )
2023-05-19 14:43:06 -03:00 · 2023-05-19 07:04:16 -03:00 · 2023-05-19 11:15:52 +02:00 · 2023-05-18 21:19:01 -03:00 · 2023-05-18 15:09:57 -03:00 · 2023-05-18 07:21:30 -03:00
106 changed files with 6651 additions and 805 deletions
--- a/.gitignore
+++ b/.gitignore
@@ -16,6 +16,7 @@ node_modules
 *.launch
 .settings/
 *.sublime-workspace
+.obsidian

 # IDE - VSCode
 .vscode/*
--- a/examples/alan-turing-portal/markdown.db
+++ b/examples/alan-turing-portal/markdown.db
--- a/examples/fivethirtyeight/README.md
+++ b/examples/fivethirtyeight/README.md
@@ -1,4 +1,10 @@
-This is a [Next.js](https://nextjs.org/) project bootstrapped with [`create-next-app`](https://github.com/vercel/next.js/tree/canary/packages/create-next-app).
+This is a replica of the awesome data.fivethirtyeight.com using PortalJS.
+
+You might be asking why we did that, there are three main reasons:
+
+- The website has a great UI, with multiple datasets being displayed elegantly and with simplicity.
+- PortalJS allows us to add more functionality to it e.g dataset previews and search functionality.
+- The project follows our same principles of open sourcing and free data, with every dataset being publicly available on Github.

 ## Getting Started

--- a/examples/fivethirtyeight/datasets.json
+++ b/examples/fivethirtyeight/datasets.json
@@ -211,18 +211,6 @@
      "https://projects.fivethirtyeight.com/nfl-api/nfl_elo_latest.csv"
    ]
  },
-  {
-    "url": "https://github.com/fivethirtyeight/checking-our-work-data",
-    "name": "checking-our-work-data",
-    "displayName": "checking-our-work-<span class=\"lastword\">data</span>",
-    "articles": [
-      {
-        "date": "2023-02-02T16:30:00.000Z",
-        "title": "How Good Are FiveThirtyEight Forecasts?",
-        "url": "https://projects.fivethirtyeight.com/checking-our-work/"
-      }
-    ]
-  },
  {
    "url": "https://github.com/fivethirtyeight/data/tree/master/world-cup-2022",
    "name": "world-cup-2022",
@@ -239,18 +227,6 @@
      "https://projects.fivethirtyeight.com/soccer-api/international/2022/wc_forecasts.csv"
    ]
  },
-  {
-    "url": "https://github.com/fivethirtyeight/covid-19-polls",
-    "name": "covid-19-polls",
-    "displayName": "covid-19-<span class=\"lastword\">polls</span>",
-    "articles": [
-      {
-        "date": "2022-11-29T20:20:08.000Z",
-        "title": "How Americans View Biden’s Response To The Coronavirus Crisis",
-        "url": "https://projects.fivethirtyeight.com/coronavirus-polls/"
-      }
-    ]
-  },
  {
    "url": "https://github.com/fivethirtyeight/data/tree/master/election-deniers",
    "name": "election-deniers",
@@ -371,18 +347,6 @@
      }
    ]
  },
-  {
-    "url": "https://github.com/fivethirtyeight/nfl-elo-game",
-    "name": "nfl-elo-game",
-    "displayName": "nfl-elo-<span class=\"lastword\">game</span>",
-    "articles": [
-      {
-        "date": "2022-02-14T03:03:26.000Z",
-        "title": "Can You Beat FiveThirtyEight’s NFL Forecasts?",
-        "url": "https://projects.fivethirtyeight.com/2021-nfl-forecasting-game/"
-      }
-    ]
-  },
  {
    "url": "https://github.com/fivethirtyeight/data/tree/master/redlining",
    "name": "redlining",
@@ -407,42 +371,6 @@
      }
    ]
  },
-  {
-    "url": "https://github.com/fivethirtyeight/negro-leagues-player-ratings",
-    "name": "negro-leagues-player-ratings",
-    "displayName": "negro-leagues-player-<span class=\"lastword\">ratings</span>",
-    "articles": [
-      {
-        "date": "2021-02-25T11:00:00.000Z",
-        "title": "The Negro League Stars That MLB Kept Out — And Is Finally Recognizing",
-        "url": "https://projects.fivethirtyeight.com/negro-leagues-mlb/"
-      }
-    ]
-  },
-  {
-    "url": "https://github.com/fivethirtyeight/police-settlements",
-    "name": "police-settlements",
-    "displayName": "police-<span class=\"lastword\">settlements</span>",
-    "articles": [
-      {
-        "date": "2021-02-22T11:00:49.000Z",
-        "title": "Cities Spend Millions On Police Misconduct Every Year. Here’s Why It’s So Difficult to Hold Departments Accountable.",
-        "url": "https://fivethirtyeight.com/features/police-misconduct-costs-cities-millions-every-year-but-thats-where-the-accountability-ends/"
-      }
-    ]
-  },
-  {
-    "url": "https://github.com/fivethirtyeight/superbowl-ads",
-    "name": "superbowl-ads",
-    "displayName": "superbowl-<span class=\"lastword\">ads</span>",
-    "articles": [
-      {
-        "date": "2021-02-04T16:11:00.000Z",
-        "title": "According To Super Bowl Ads, Americans Love America, Animals And Sex",
-        "url": "https://projects.fivethirtyeight.com/super-bowl-ads/"
-      }
-    ]
-  },
  {
    "url": "https://github.com/fivethirtyeight/data/tree/master/trump-approval-ratings",
    "name": "trump-approval-ratings",
@@ -475,18 +403,6 @@
      "https://projects.fivethirtyeight.com/congress-tracker-data/csv/vote_predictions.csv"
    ]
  },
-  {
-    "url": "https://github.com/fivethirtyeight/election-results",
-    "name": "election-results",
-    "displayName": "election-<span class=\"lastword\">results</span>",
-    "articles": [
-      {
-        "date": "2020-11-03T05:33:43.000Z",
-        "title": "2020 Election Forecast",
-        "url": "https://projects.fivethirtyeight.com/2020-election-forecast/"
-      }
-    ]
-  },
  {
    "url": "https://github.com/fivethirtyeight/data/tree/master/election-forecasts-2020",
    "name": "election-forecasts-2020",
@@ -557,18 +473,6 @@
      }
    ]
  },
-  {
-    "url": "https://github.com/fivethirtyeight/WNBA-stats",
-    "name": "WNBA-stats",
-    "displayName": "WNBA-<span class=\"lastword\">stats</span>",
-    "articles": [
-      {
-        "date": "2020-05-27T19:06:43.000Z",
-        "title": "It’s Time To Give Basketball’s Other GOAT Her Due",
-        "url": "https://fivethirtyeight.com/features/its-time-to-give-basketballs-other-goat-her-due/"
-      }
-    ]
-  },
  {
    "url": "https://github.com/fivethirtyeight/data/tree/master/covid-geography",
    "name": "covid-geography",
@@ -608,18 +512,6 @@
      "https://projects.fivethirtyeight.com/endorsements-2020-data/endorsements-2020.csv"
    ]
  },
-  {
-    "url": "https://github.com/fivethirtyeight/nba-player-advanced-metrics",
-    "name": "nba-player-advanced-metrics",
-    "displayName": "nba-player-advanced-<span class=\"lastword\">metrics</span>",
-    "articles": [
-      {
-        "date": "2020-03-09T15:27:37.000Z",
-        "title": "Luka Dončić And The Mavs Are Pushing The Limits Of Offensive Efficiency",
-        "url": "https://fivethirtyeight.com/features/luka-doncic-and-the-mavs-are-pushing-the-limits-of-offensive-efficiency/"
-      }
-    ]
-  },
  {
    "url": "https://github.com/fivethirtyeight/data/tree/master/impeachment-polls",
    "name": "impeachment-polls",
@@ -711,18 +603,6 @@
      }
    ]
  },
-  {
-    "url": "https://github.com/fivethirtyeight/candidate-emails",
-    "name": "candidate-emails",
-    "displayName": "candidate-<span class=\"lastword\">emails</span>",
-    "articles": [
-      {
-        "date": "2019-07-11T15:33:15.000Z",
-        "title": "What Our Inbox Tells Us About How Democrats Are Tackling Trump",
-        "url": "https://fivethirtyeight.com/features/which-democrats-are-campaigning-on-trump/"
-      }
-    ]
-  },
  {
    "url": "https://github.com/fivethirtyeight/data/tree/master/nba-draymond",
    "name": "nba-draymond",
@@ -763,18 +643,6 @@
      }
    ]
  },
-  {
-    "url": "https://github.com/fivethirtyeight/twitter-overlap",
-    "name": "twitter-overlap",
-    "displayName": "twitter-<span class=\"lastword\">overlap</span>",
-    "articles": [
-      {
-        "date": "2019-06-12T15:24:07.000Z",
-        "title": "Which 2020 Candidates Have The Most In Common … On Twitter?",
-        "url": "https://fivethirtyeight.com/features/which-2020-candidates-have-the-most-in-common-on-twitter/"
-      }
-    ]
-  },
  {
    "url": "https://github.com/fivethirtyeight/data/tree/master/trump-lawsuits",
    "name": "trump-lawsuits",
@@ -957,18 +825,6 @@
      "https://projects.fivethirtyeight.com/congress-model-2018/governor_state_forecast.csv"
    ]
  },
-  {
-    "url": "https://github.com/fivethirtyeight/actblue-analysis",
-    "name": "actblue-analysis",
-    "displayName": "actblue-<span class=\"lastword\">analysis</span>",
-    "articles": [
-      {
-        "date": "2018-10-25T17:31:42.000Z",
-        "title": "How ActBlue Is Trying To Turn Small Donations Into A Blue Wave",
-        "url": "https://fivethirtyeight.com/features/how-actblue-is-trying-to-turn-small-donations-into-a-blue-wave"
-      }
-    ]
-  },
  {
    "url": "https://github.com/fivethirtyeight/data/tree/master/primary-candidates-2018",
    "name": "primary-candidates-2018",
@@ -1179,18 +1035,6 @@
      }
    ]
  },
-  {
-    "url": "https://github.com/fivethirtyeight/redistricting-atlas-data",
-    "name": "redistricting-atlas-data",
-    "displayName": "redistricting-atlas-<span class=\"lastword\">data</span>",
-    "articles": [
-      {
-        "date": "2018-01-25T11:00:00.000Z",
-        "title": "The Atlas Of Redistricting",
-        "url": "https://projects.fivethirtyeight.com/redistricting-maps/"
-      }
-    ]
-  },
  {
    "url": "https://github.com/fivethirtyeight/data/tree/master/next-bechdel",
    "name": "next-bechdel",
@@ -1620,37 +1464,6 @@
      }
    ]
  },
-  {
-    "url": "https://github.com/fivethirtyeight/uber-tlc-foil-response",
-    "name": "uber-tlc-foil-response",
-    "displayName": "uber-tlc-foil-<span class=\"lastword\">response</span>",
-    "articles": [
-      {
-        "date": "2015-12-09T16:19:40.000Z",
-        "title": "Is Uber Making NYC Rush-Hour Traffic Worse?",
-        "rowspan": 4,
-        "url": "https://fivethirtyeight.com/features/is-uber-making-nyc-rush-hour-traffic-worse/"
-      },
-      {
-        "date": "2015-10-13T20:44:12.000Z",
-        "title": "Uber Is Taking Millions Of Manhattan Rides Away From Taxis",
-        "rowspan": 0,
-        "url": "https://fivethirtyeight.com/features/uber-is-taking-millions-of-manhattan-rides-away-from-taxis/"
-      },
-      {
-        "date": "2015-08-28T10:30:36.000Z",
-        "title": "Public Transit Should Be Uber’s New Best Friend",
-        "rowspan": 0,
-        "url": "https://fivethirtyeight.com/features/public-transit-should-be-ubers-new-best-friend/"
-      },
-      {
-        "date": "2015-08-10T18:06:17.000Z",
-        "title": "Uber Is Serving New York’s Outer Boroughs More Than Taxis Are",
-        "rowspan": 0,
-        "url": "https://fivethirtyeight.com/features/uber-is-serving-new-yorks-outer-boroughs-more-than-taxis-are/"
-      }
-    ]
-  },
  {
    "url": "https://github.com/fivethirtyeight/data/tree/master/tarantino",
    "name": "tarantino",
@@ -2169,18 +1982,6 @@
      }
    ]
  },
-  {
-    "url": "https://github.com/fivethirtyeight/data/tree/master/comma-survey-data",
-    "name": "comma-survey-data",
-    "displayName": "comma-survey-<span class=\"lastword\">data</span>",
-    "articles": [
-      {
-        "date": "2014-06-17T16:28:55.000Z",
-        "title": "Elitist, Superfluous, Or Popular? We Polled Americans on the Oxford Comma",
-        "url": "http://fivethirtyeight.com/features/elitist-superfluous-or-popular-we-polled-americans-on-the-oxford-comma/"
-      }
-    ]
-  },
  {
    "url": "https://github.com/fivethirtyeight/data/tree/master/world-cup-predictions",
    "name": "world-cup-predictions",
@@ -2350,4 +2151,4 @@
      }
    ]
  }
-]
+]
--- a/examples/fivethirtyeight/pages/_document.tsx
+++ b/examples/fivethirtyeight/pages/_document.tsx
@@ -9,33 +9,81 @@ export default function Document() {
          type="image/x-icon"
          href="https://projects.fivethirtyeight.com/shared/favicon.ico"
        />
+        <meta
+          property="og:image"
+          content="https://portaljs-fivethirtyeight.vercel.app/share_image.png"
+        />
+        <meta
+          property="twitter:image"
+          content="https://portaljs-fivethirtyeight.vercel.app/share_image.png"
+        />
      </Head>
      <body>
-        <header className="max-w-5xl mx-auto mt-8 w-full">
-          <div className="border-b-2 pb-2.5 mx-2 border-zinc-800">
-            <h1>
-              <span className="sr-only">FiveThirtyEight</span>
+        <div className="px-2 max-w-5xl mx-auto pb-2">
+          <div className="mt-2 px-2 bg-[#3c3c3c] text-white">
+            <div className="p-2 text-center">
+              This is a replica to the awesome{' '}
              <a
-                className="flex gap-x-2 items-center"
-                href="http://fivethirtyeight.com"
+                className="hover:underline font-bold"
+                href="https://data.fivethirtyeight.com"
              >
-                <img
-                  width="197"
-                  height="25"
-                  alt="FiveThirtyEight"
-                  src="data:image/svg+xml;base64,PHN2ZyBpZD0iTGF5ZXJfMSIgZGF0YS1uYW1lPSJMYXllciAxIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCA0MjEgNTMuNzYiPjxkZWZzPjxzdHlsZT4uY2xzLTF7ZmlsbDojMDEwMTAxO308L3N0eWxlPjwvZGVmcz48dGl0bGU+QXJ0Ym9hcmQgOTU8L3RpdGxlPjxwYXRoIGNsYXNzPSJjbHMtMSIgZD0iTTAgMGgyNXY4SDl2MTBoMTV2OEg5djE3SDBWMHpNMzEgMzZoNVYxOGgtNXYtOGgxM3YyNmg0djdIMzF6bTUtMzZoOHY4aC04ek0xNzkgMzZoNVYxOGgtNXYtOGgxM3YyNmg0djdoLTE3em01LTM2aDh2OGgtOHpNMzE2IDM2aDVWMThoLTV2LThoMTN2MjZoNHY3aC0xN3ptNS0zNmg4djhoLTh6TTU0IDI3VjEwaDh2MTVsNCA5Ljk4aDFMNzEgMjVWMTBoOHYxN2wtNyAxNkg2MWwtNy0xNnpNMTExIDQzSDk3LjQyQzg5LjIzIDQzIDg1IDM5LjE5IDg1IDMxLjE3VjIyYzAtNy41NyA0LjMtMTMgMTMtMTMgOS4zMyAwIDEzIDUuMDcgMTMgMTR2N0g5NHYxLjc0YzAgMi42MiAxIDQuMjYgMy40MiA0LjI2SDExMXpNOTQgMjNoOHYtMS41NWMwLTIuNjItMS4wNi01LjQ1LTQuMTMtNS40NS0yLjc5IDAtMy44NyAyLjItMy44NyA1LjQ1ek0xMjUgOGgtMTBWMGgyOXY4aC0xMHYzNWgtOVY4ek0yMDIgNDNWMTBoOHY0YzEuMTQtMi40NSAzLjc1LTQgNy4yMi00SDIyMHY4aC02Yy0yLjg0IDAtNCAuOTQtNCAzLjlWNDN6TTI0NSA0M2gtNC44NEMyMzMuMDUgNDMgMjMwIDM5LjMxIDIzMCAzMS44NVYxOGgtNnYtOGg2VjNoOHY3aDd2OGgtN2wtLjA3IDEzLjkzYzAgMi4yMi45MyA0LjA3IDMuNjYgNC4wN0gyNDV6TTQyMSA0M2gtNC44NEM0MDkuMDUgNDMgNDA2IDM5LjMxIDQwNiAzMS44NVYxOGgtNnYtOGg2VjNoOHY3aDd2OGgtN2wtLjA3IDEzLjkzYzAgMi4yMi45MyA0LjA3IDMuNjYgNC4wN0g0MjF6TTI1NC4yNiA1My43Nmw0LjYxLTkuNUwyNTEgMjdWMTBoOHYxNWw0IDEwaDFsNC0xMFYxMGg4djE3bC0xMi4zIDI2Ljc2aC05LjQ0ek0yODQgMGgyNXY4aC0xNnY5aDE1djhoLTE1djEwaDE2djhoLTI1VjB6TTMzNyA0OHYtMmgxNi4xYzIgMCAyLjktLjE4IDIuOS0xLjI3di0uMzRjMC0xLjA4LS45MS0xLjM5LTIuOS0xLjM5SDM0MHYtNWw1LTVjLTUuMjktMS40OC04LTUuNDMtOC0xMXYtMWMwLTcuNTYgNC40NC0xMiAxNC0xMmEyMS45MyAyMS45MyAwIDAgMSA1Ljk1IDFMMzYxIDRsNSAzLTQgNmMxLjM3IDEuOTMgMyA0LjkzIDMgOHYxYzAgNy0zLjMgMTAuNjYtMTIgMTFsLTMgNGg2YzUuOTIgMCA5IDIuNjIgOSA3LjY4di4xMWMwIDUuMDYtMi43MSA4LjIxLTguNjIgOC4yMWgtMTNjLTQuMjkgMC02LjM4LTEuODQtNi4zOC01em0xOS0yNXYtM2MwLTMuMy0xLjMzLTQtNS00cy01IC43LTUgNHYzYzAgMy4zIDEuMzkgNCA1IDRzNS0uNyA1LTR6TTM4MCA0M2gtOFYwaDh2MTRjMS4xNC0yLjY3IDMuNC00IDctNCA2LjI2IDAgOSAzLjA4IDkgMTAuNzZWNDNoLThWMjJjMC0zLjEzLTEuMDctNS00LTVzLTQgMS44Ny00IDV6TTE1NyA0M2gtOFYwaDh2MTRjMS4xNC0yLjY3IDMuOTEtNCA3LjQ5LTQgNi4yNiAwIDguNTEgMy4xMyA4LjUxIDEwLjgxVjQzaC04VjIxYzAtMy4xMy0xLjA3LTQuNDQtNC00LjQ0cy00IDIuMjYtNCA1LjM5eiIvPjwvc3ZnPg=="
-                />{' '}
-                by PortalJS
-              </a>
-            </h1>
+                data.fivethirtyeight.com
+              </a>{' '}
+              website.{' '}
+              <a
+                className="hover:underline font-bold"
+                href="https://github.com/datopian/portaljs/tree/main/examples/fivethirtyeight"
+              >
+                Read more here
+              </a>{' '}
+            </div>
          </div>
-          <div className="mx-2 py-1.5 text-[14px] text-[#3c3c3c]">
-            <ul className='flex gap-x-4'>
+        </div>
+        <header className="max-w-5xl mx-auto mt-8 w-full">
+          <div className="border-b-2 pb-2.5 mx-2 border-zinc-800 flex justify-between">
+            <h1 className="flex gap-x-1 items-end">
+              <span className="sr-only">FiveThirtyEight</span>
+              <img
+                width="197"
+                height="25"
+                alt="FiveThirtyEight"
+                src="data:image/svg+xml;base64,PHN2ZyBpZD0iTGF5ZXJfMSIgZGF0YS1uYW1lPSJMYXllciAxIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCA0MjEgNTMuNzYiPjxkZWZzPjxzdHlsZT4uY2xzLTF7ZmlsbDojMDEwMTAxO308L3N0eWxlPjwvZGVmcz48dGl0bGU+QXJ0Ym9hcmQgOTU8L3RpdGxlPjxwYXRoIGNsYXNzPSJjbHMtMSIgZD0iTTAgMGgyNXY4SDl2MTBoMTV2OEg5djE3SDBWMHpNMzEgMzZoNVYxOGgtNXYtOGgxM3YyNmg0djdIMzF6bTUtMzZoOHY4aC04ek0xNzkgMzZoNVYxOGgtNXYtOGgxM3YyNmg0djdoLTE3em01LTM2aDh2OGgtOHpNMzE2IDM2aDVWMThoLTV2LThoMTN2MjZoNHY3aC0xN3ptNS0zNmg4djhoLTh6TTU0IDI3VjEwaDh2MTVsNCA5Ljk4aDFMNzEgMjVWMTBoOHYxN2wtNyAxNkg2MWwtNy0xNnpNMTExIDQzSDk3LjQyQzg5LjIzIDQzIDg1IDM5LjE5IDg1IDMxLjE3VjIyYzAtNy41NyA0LjMtMTMgMTMtMTMgOS4zMyAwIDEzIDUuMDcgMTMgMTR2N0g5NHYxLjc0YzAgMi42MiAxIDQuMjYgMy40MiA0LjI2SDExMXpNOTQgMjNoOHYtMS41NWMwLTIuNjItMS4wNi01LjQ1LTQuMTMtNS40NS0yLjc5IDAtMy44NyAyLjItMy44NyA1LjQ1ek0xMjUgOGgtMTBWMGgyOXY4aC0xMHYzNWgtOVY4ek0yMDIgNDNWMTBoOHY0YzEuMTQtMi40NSAzLjc1LTQgNy4yMi00SDIyMHY4aC02Yy0yLjg0IDAtNCAuOTQtNCAzLjlWNDN6TTI0NSA0M2gtNC44NEMyMzMuMDUgNDMgMjMwIDM5LjMxIDIzMCAzMS44NVYxOGgtNnYtOGg2VjNoOHY3aDd2OGgtN2wtLjA3IDEzLjkzYzAgMi4yMi45MyA0LjA3IDMuNjYgNC4wN0gyNDV6TTQyMSA0M2gtNC44NEM0MDkuMDUgNDMgNDA2IDM5LjMxIDQwNiAzMS44NVYxOGgtNnYtOGg2VjNoOHY3aDd2OGgtN2wtLjA3IDEzLjkzYzAgMi4yMi45MyA0LjA3IDMuNjYgNC4wN0g0MjF6TTI1NC4yNiA1My43Nmw0LjYxLTkuNUwyNTEgMjdWMTBoOHYxNWw0IDEwaDFsNC0xMFYxMGg4djE3bC0xMi4zIDI2Ljc2aC05LjQ0ek0yODQgMGgyNXY4aC0xNnY5aDE1djhoLTE1djEwaDE2djhoLTI1VjB6TTMzNyA0OHYtMmgxNi4xYzIgMCAyLjktLjE4IDIuOS0xLjI3di0uMzRjMC0xLjA4LS45MS0xLjM5LTIuOS0xLjM5SDM0MHYtNWw1LTVjLTUuMjktMS40OC04LTUuNDMtOC0xMXYtMWMwLTcuNTYgNC40NC0xMiAxNC0xMmEyMS45MyAyMS45MyAwIDAgMSA1Ljk1IDFMMzYxIDRsNSAzLTQgNmMxLjM3IDEuOTMgMyA0LjkzIDMgOHYxYzAgNy0zLjMgMTAuNjYtMTIgMTFsLTMgNGg2YzUuOTIgMCA5IDIuNjIgOSA3LjY4di4xMWMwIDUuMDYtMi43MSA4LjIxLTguNjIgOC4yMWgtMTNjLTQuMjkgMC02LjM4LTEuODQtNi4zOC01em0xOS0yNXYtM2MwLTMuMy0xLjMzLTQtNS00cy01IC43LTUgNHYzYzAgMy4zIDEuMzkgNCA1IDRzNS0uNyA1LTR6TTM4MCA0M2gtOFYwaDh2MTRjMS4xNC0yLjY3IDMuNC00IDctNCA2LjI2IDAgOSAzLjA4IDkgMTAuNzZWNDNoLThWMjJjMC0zLjEzLTEuMDctNS00LTVzLTQgMS44Ny00IDV6TTE1NyA0M2gtOFYwaDh2MTRjMS4xNC0yLjY3IDMuOTEtNCA3LjQ5LTQgNi4yNiAwIDguNTEgMy4xMyA4LjUxIDEwLjgxVjQzaC04VjIxYzAtMy4xMy0xLjA3LTQuNDQtNC00LjQ0cy00IDIuMjYtNCA1LjM5eiIvPjwvc3ZnPg=="
+              />{' '}
+              <span className="-mb-0.5 text-[#3c3c3c]">replica</span>
+            </h1>
+            <div className="md:flex items-center gap-x-3 text-[#3c3c3c] -mb-1 hidden">
+              <a
+                className="hover:opacity-75 transition"
+                href="https://portaljs.org"
+              >
+                Built with 🌀PortalJS
+              </a>
+              <hr className="h-[80%] border border-[#3c3c3c] opacity-75 my-2"></hr>
+              <a
+                className="hover:opacity-75 transition"
+                href="https://github.com/datopian/portaljs/tree/main/examples/fivethirtyeight"
+              >
+                Github
+              </a>
+            </div>
+          </div>
+          <div className="mx-2 py-1.5 text-[14px] text-[#3c3c3c] md:hidden">
+            <ul className="flex gap-x-4">
              <li>
-                <a className='hover:opacity-75 transition' href="https://portaljs.org">PortalJS</a>
+                <a
+                  className="hover:opacity-75 transition"
+                  href="https://portaljs.org"
+                >
+                  PortalJS
+                </a>
              </li>
              <li>
-                <a className='hover:opacity-75 transition' href="https://github.com/datopian/portaljs/tree/main/examples/fivethirtyeight">View on Github</a>
+                <a
+                  className="hover:opacity-75 transition"
+                  href="https://github.com/datopian/portaljs/tree/main/examples/fivethirtyeight"
+                >
+                  View on Github
+                </a>
              </li>
            </ul>
          </div>
--- a/examples/fivethirtyeight/pages/index.tsx
+++ b/examples/fivethirtyeight/pages/index.tsx
@@ -3,6 +3,7 @@ import { Inter } from 'next/font/google';
 import { format } from 'timeago.js';
 import { promises as fs } from 'fs';
 import path from 'path';
+import { NextSeo } from 'next-seo';

 const inter = Inter({ subsets: ['latin'] });

@@ -31,11 +32,7 @@ export function MobileItem({ dataset }: { dataset: Dataset }) {
  return (
    <div className="flex gap-x-2 pb-2 py-4 items-center justify-between border-b border-zinc-600">
      <div className="flex flex-col">
-        <span className="font-mono font-light">
-          <a className="underline" href={dataset.url} target="_blank">
-            {dataset.name}
-          </a>
-        </span>
+        <span className="font-mono font-light">{dataset.name}</span>
        {dataset.articles.map((article) => (
          <div key={article.title} className="py-1 flex flex-col">
            <span className="font-bold hover:underline">{article.title}</span>
@@ -50,9 +47,9 @@ export function MobileItem({ dataset }: { dataset: Dataset }) {
      <div className="flex flex-col justify-start">
        <a
          className="ml-2 border border-zinc-900 font-light px-4 py-1 text-sm transition hover:bg-zinc-900 hover:text-white"
-          href={`/datasets/${dataset.name}`}
+          href={dataset.url}
        >
-          explore
+          info
        </a>
        {/*
                <button>
@@ -84,10 +81,8 @@ export function DesktopItem({ dataset }: { dataset: Dataset }) {
            index === dataset.articles.length - 1 ? 'border-b' : ''
          } border-zinc-400`}
        >
-          <td className="py-8 font-light font-mono text-[14px] text-zinc-700">
-            <a className="underline" href={dataset.url} target="_blank">
-              {index === 0 ? dataset.name : ''}
-            </a>
+          <td className="py-8 font-light font-mono text-[13px] text-zinc-700">
+            {index === 0 ? dataset.name : ''}
          </td>
          <td>
            <a
@@ -106,9 +101,9 @@ export function DesktopItem({ dataset }: { dataset: Dataset }) {
            {index === 0 && (
              <a
                className="ml-2 border border-zinc-900 font-light px-[25px] py-2.5 text-sm transition hover:bg-zinc-900 hover:text-white"
-                href={`/datasets/${dataset.name}`}
+                href={dataset.url}
              >
-                explore
+                info
              </a>
            )}
          </td>
@@ -147,6 +142,7 @@ export async function getStaticProps() {
 export default function Home({ datasets }: { datasets: Dataset[] }) {
  return (
    <>
+      <NextSeo title="FiveThirtyEight tribute by PortalJS" />
      <main
        className={`flex min-h-screen flex-col items-center max-w-5xl mx-auto pt-20 px-2.5 ${inter.className}`}
      >
--- a/examples/fivethirtyeight/public/share_image.png
+++ b/examples/fivethirtyeight/public/share_image.png
--- a/examples/github-backed-catalog/.eslintrc.json
+++ b/examples/github-backed-catalog/.eslintrc.json
@@ -1,8 +1,5 @@
 {
-  "extends": [
-    "next",
-    "next/core-web-vitals"
-  ],
+  "extends": ["next", "next/core-web-vitals"],
  "ignorePatterns": ["!**/*", ".next/**/*"],
  "overrides": [
    {
--- a/examples/github-backed-catalog/.prettierignore
+++ b/examples/github-backed-catalog/.prettierignore
@@ -0,0 +1,7 @@
+node_modules
+**/.next/**
+**/_next/**
+**/dist/**
+**/__tmp__/**
+lerna.json
+.github
--- a/examples/github-backed-catalog/.prettierrc.json
+++ b/examples/github-backed-catalog/.prettierrc.json
@@ -0,0 +1 @@
+{}
--- a/examples/github-backed-catalog/README.md
+++ b/examples/github-backed-catalog/README.md
@@ -99,4 +99,3 @@ And run the production build with:
 ```
 npm run start
 ```
-
--- a/examples/github-backed-catalog/components/_shared/Breadcrumbs.tsx
+++ b/examples/github-backed-catalog/components/_shared/Breadcrumbs.tsx
@@ -1,20 +1,28 @@
 import Link from "next/link";
 import HomeIcon from "../icons/HomeIcon";

-export default function Breadcrumbs({ links }: { links: { title: string, href?: string, target?: string }[] }) {
+export default function Breadcrumbs({
+  links,
+}: {
+  links: { title: string; href?: string; target?: string }[];
+}) {
  const current = links.at(-1);

-  return <div className="flex items-center uppercase font-black text-xs">
-    <Link className="flex items-center" href='/'><HomeIcon /></Link>
+  return (
+    <div className="flex items-center uppercase font-black text-xs">
+      <Link className="flex items-center" href="/">
+        <HomeIcon />
+      </Link>

-    {/* {links.length > 1 && links.slice(0, -1).map((link) => {
+      {/* {links.length > 1 && links.slice(0, -1).map((link) => {
      return <>
        <span className="mx-4">/</span>
        <Link href={link.href}>{link.title}</Link>
      </>
    })} */}

-    <span className="mx-4">/</span>
-    <span>{current.title}</span>
-  </div >
-}
+      <span className="mx-4">/</span>
+      <span>{current.title}</span>
+    </div>
+  );
+}
--- a/examples/github-backed-catalog/components/icons/ExternalLinkIcon.tsx
+++ b/examples/github-backed-catalog/components/icons/ExternalLinkIcon.tsx
@@ -1,3 +1,13 @@
 export default function ExternalLinkIcon({ className = "" }) {
-  return <div className={`inline-block w-4 ${className}`}><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" fill="currentColor"><path d="M 40 10 C 38.896 10 38 10.896 38 12 C 38 13.104 38.896 14 40 14 L 47.171875 14 L 30.585938 30.585938 C 29.804938 31.366938 29.804938 32.633063 30.585938 33.414062 C 30.976938 33.805063 31.488 34 32 34 C 32.512 34 33.023063 33.805062 33.414062 33.414062 L 50 16.828125 L 50 24 C 50 25.104 50.896 26 52 26 C 53.104 26 54 25.104 54 24 L 54 12 C 54 10.896 53.104 10 52 10 L 40 10 z M 18 12 C 14.691 12 12 14.691 12 18 L 12 46 C 12 49.309 14.691 52 18 52 L 46 52 C 49.309 52 52 49.309 52 46 L 52 34 C 52 32.896 51.104 32 50 32 C 48.896 32 48 32.896 48 34 L 48 46 C 48 47.103 47.103 48 46 48 L 18 48 C 16.897 48 16 47.103 16 46 L 16 18 C 16 16.897 16.897 16 18 16 L 30 16 C 31.104 16 32 15.104 32 14 C 32 12.896 31.104 12 30 12 L 18 12 z"/></svg></div>
-}
+  return (
+    <div className={`inline-block w-4 ${className}`}>
+      <svg
+        xmlns="http://www.w3.org/2000/svg"
+        viewBox="0 0 64 64"
+        fill="currentColor"
+      >
+        <path d="M 40 10 C 38.896 10 38 10.896 38 12 C 38 13.104 38.896 14 40 14 L 47.171875 14 L 30.585938 30.585938 C 29.804938 31.366938 29.804938 32.633063 30.585938 33.414062 C 30.976938 33.805063 31.488 34 32 34 C 32.512 34 33.023063 33.805062 33.414062 33.414062 L 50 16.828125 L 50 24 C 50 25.104 50.896 26 52 26 C 53.104 26 54 25.104 54 24 L 54 12 C 54 10.896 53.104 10 52 10 L 40 10 z M 18 12 C 14.691 12 12 14.691 12 18 L 12 46 C 12 49.309 14.691 52 18 52 L 46 52 C 49.309 52 52 49.309 52 46 L 52 34 C 52 32.896 51.104 32 50 32 C 48.896 32 48 32.896 48 34 L 48 46 C 48 47.103 47.103 48 46 48 L 18 48 C 16.897 48 16 47.103 16 46 L 16 18 C 16 16.897 16.897 16 18 16 L 30 16 C 31.104 16 32 15.104 32 14 C 32 12.896 31.104 12 30 12 L 18 12 z" />
+      </svg>
+    </div>
+  );
+}
--- a/examples/github-backed-catalog/components/icons/HomeIcon.tsx
+++ b/examples/github-backed-catalog/components/icons/HomeIcon.tsx
@@ -1,3 +1,10 @@
 export default function HomeIcon({ className = "" }) {
-  return <div className={`inline-block w-4 ${className}`}><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">    <path d="M 12 2 A 1 1 0 0 0 11.289062 2.296875 L 1.203125 11.097656 A 0.5 0.5 0 0 0 1 11.5 A 0.5 0.5 0 0 0 1.5 12 L 4 12 L 4 20 C 4 20.552 4.448 21 5 21 L 9 21 C 9.552 21 10 20.552 10 20 L 10 14 L 14 14 L 14 20 C 14 20.552 14.448 21 15 21 L 19 21 C 19.552 21 20 20.552 20 20 L 20 12 L 22.5 12 A 0.5 0.5 0 0 0 23 11.5 A 0.5 0.5 0 0 0 22.796875 11.097656 L 12.716797 2.3027344 A 1 1 0 0 0 12.710938 2.296875 A 1 1 0 0 0 12 2 z"/></svg></div>
-}
+  return (
+    <div className={`inline-block w-4 ${className}`}>
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+        {" "}
+        <path d="M 12 2 A 1 1 0 0 0 11.289062 2.296875 L 1.203125 11.097656 A 0.5 0.5 0 0 0 1 11.5 A 0.5 0.5 0 0 0 1.5 12 L 4 12 L 4 20 C 4 20.552 4.448 21 5 21 L 9 21 C 9.552 21 10 20.552 10 20 L 10 14 L 14 14 L 14 20 C 14 20.552 14.448 21 15 21 L 19 21 C 19.552 21 20 20.552 20 20 L 20 12 L 22.5 12 A 0.5 0.5 0 0 0 23 11.5 A 0.5 0.5 0 0 0 22.796875 11.097656 L 12.716797 2.3027344 A 1 1 0 0 0 12.710938 2.296875 A 1 1 0 0 0 12 2 z" />
+      </svg>
+    </div>
+  );
+}
--- a/examples/github-backed-catalog/datasets.json
+++ b/examples/github-backed-catalog/datasets.json
@@ -19,10 +19,7 @@
    "owner": "datasets",
    "branch": "main",
    "repo": "investor-flow-of-funds-us",
-    "files": [
-      "data/monthly.csv",
-      "data/weekly.csv"
-    ],
+    "files": ["data/monthly.csv", "data/weekly.csv"],
    "readme": "README.md"
  },
  {
@@ -38,7 +35,10 @@
    "owner": "fivethirtyeight",
    "repo": "data",
    "branch": "master",
-    "files": ["nba-raptor/historical_RAPTOR_by_player.csv", "nba-raptor/historical_RAPTOR_by_team.csv"],
+    "files": [
+      "nba-raptor/historical_RAPTOR_by_player.csv",
+      "nba-raptor/historical_RAPTOR_by_team.csv"
+    ],
    "readme": "nba-raptor/README.md"
  }
 ]
--- a/examples/github-backed-catalog/index.d.ts
+++ b/examples/github-backed-catalog/index.d.ts
@@ -1,5 +1,5 @@
 /* eslint-disable @typescript-eslint/no-explicit-any */
-declare module '*.svg' {
+declare module "*.svg" {
  const content: any;
  export const ReactComponent: any;
  export default content;
--- a/examples/github-backed-catalog/lib/octokit.ts
+++ b/examples/github-backed-catalog/lib/octokit.ts
@@ -1,4 +1,4 @@
-import { Octokit } from 'octokit';
+import { Octokit } from "octokit";

 export interface GithubProject {
  owner: string;
@@ -26,15 +26,16 @@ export async function getProjectReadme(
      ref: branch,
    });
    const data = response.data as { content?: string };
-    const fileContent = data.content ? data.content : '';
-    if (fileContent === '') {
+    const fileContent = data.content ? data.content : "";
+    if (fileContent === "") {
      return null;
    }
-    const decodedContent = Buffer.from(fileContent, 'base64').toString();
+    const decodedContent = Buffer.from(fileContent, "base64").toString();
    return decodedContent;
  } catch (error) {
-    console.log(error);
-    return null;
+    throw new Error(
+      "Couldn't get project readme please make sure that you are pointing to a valid repo and that the repo in question contains a README.md"
+    );
  }
 }

@@ -50,13 +51,13 @@ export async function getLastUpdated(
    const response = await octokit.rest.repos.listCommits({
      owner,
      repo,
-      path: readme,
      ref: branch,
    });
    return response.data[0].commit.committer.date;
  } catch (error) {
-    console.log(error);
-    return null;
+    throw new Error(
+      "Couldn't get project list of commits please make sure that you are pointing to a valid repo"
+    );
  }
 }
 export async function getProjectMetadata(
@@ -72,8 +73,9 @@ export async function getProjectMetadata(
    });
    return response.data;
  } catch (error) {
-    console.log(error);
-    return null;
+    throw new Error(
+      "Couldn't get project metadata please make sure that you are pointing to a valid repo"
+    );
  }
 }

@@ -94,13 +96,32 @@ export async function getRepoContents(
        ref: branch,
        path: path,
      });
-      const data = response.data as { download_url?: string, name: string, size: number };
-      contents.push({ download_url: data.download_url, name: data.name, size: data.size});
+      const data = response.data as {
+        download_url?: string;
+        name: string;
+        size: number;
+      };
+      contents.push({
+        download_url: data.download_url,
+        name: data.name,
+        size: data.size,
+      });
    }
    return contents;
  } catch (error) {
-    console.log(error);
-    return null;
+    if (
+      error.message ===
+      'This endpoint can only return blobs smaller than 100 MB in size. The requested blob is too large to fetch via the API, but you can always clone the repository via Git to obtain it.: {"resource":"Blob","field":"data","code":"too_large"}'
+    ) {
+      throw new Error(
+        `The requested files ${files.join(
+          ", "
+        )} are too big making it impossible to fetch via Github API`
+      );
+    }
+    throw new Error(
+      "Couldn't get project contents please make sure that you are pointing to a valid repo"
+    );
  }
 }

@@ -120,22 +141,20 @@ export async function getProject(project: GithubProject, github_pat?: string) {
    project.readme,
    github_pat
  );
-  if (!projectReadme) {
-    return null;
+  let projectData = [];
+  if (project.files) {
+    projectData = await getRepoContents(
+      project.owner,
+      project.repo,
+      project.branch,
+      project.files,
+      github_pat
+    );
  }
-  const projectData = await getRepoContents(
-    project.owner,
-    project.repo,
-    project.branch,
-    project.files,
-    github_pat
-  );
-  if (!projectData) {
-    return null;
-  }
-  const projectBase = project.readme.split('/').length > 1
-      ? project.readme.split('/').slice(0, -1).join('/')
-      : '/'
+  const projectBase =
+    project.readme && project.readme.split("/").length > 1
+      ? project.readme.split("/").slice(0, -1).join("/")
+      : "/";
  const last_updated = await getLastUpdated(
    project.owner,
    project.repo,
@@ -143,5 +162,11 @@ export async function getProject(project: GithubProject, github_pat?: string) {
    projectBase,
    github_pat
  );
-  return { ...projectMetadata, files: projectData, readmeContent: projectReadme, last_updated, base_path: projectBase };
+  return {
+    ...projectMetadata,
+    files: projectData,
+    readmeContent: projectReadme,
+    last_updated,
+    base_path: projectBase,
+  };
 }
--- a/examples/github-backed-catalog/next.config.js
+++ b/examples/github-backed-catalog/next.config.js
@@ -3,8 +3,8 @@ const nextConfig = {
    return {
      beforeFiles: [
        {
-          source: '/@:org/:project*',
-          destination: '/@org/:org/:project*',
+          source: "/@:org/:project*",
+          destination: "/@org/:org/:project*",
        },
      ],
    };
--- a/examples/github-backed-catalog/package-lock.json
+++ b/examples/github-backed-catalog/package-lock.json
@@ -27,6 +27,7 @@
        "@tailwindcss/typography": "^0.5.9",
        "autoprefixer": "^10.4.14",
        "postcss": "^8.4.23",
+        "prettier": "2.8.8",
        "tailwindcss": "^3.3.1"
      }
    },
@@ -4677,6 +4678,21 @@
        "node": ">= 0.8.0"
      }
    },
+    "node_modules/prettier": {
+      "version": "2.8.8",
+      "resolved": "https://registry.npmjs.org/prettier/-/prettier-2.8.8.tgz",
+      "integrity": "sha512-tdN8qQGvNjw4CHbY+XXk0JgCXn9QiF21a55rBe5LJAU+kDyC4WQn4+awm2Xfk2lQMk5fKup9XgzTZtGkjBdP9Q==",
+      "dev": true,
+      "bin": {
+        "prettier": "bin-prettier.js"
+      },
+      "engines": {
+        "node": ">=10.13.0"
+      },
+      "funding": {
+        "url": "https://github.com/prettier/prettier?sponsor=1"
+      }
+    },
    "node_modules/prop-types": {
      "version": "15.8.1",
      "resolved": "https://registry.npmjs.org/prop-types/-/prop-types-15.8.1.tgz",
--- a/examples/github-backed-catalog/package.json
+++ b/examples/github-backed-catalog/package.json
@@ -6,7 +6,8 @@
    "dev": "next dev",
    "build": "next build",
    "start": "next start",
-    "lint": "next lint"
+    "lint": "next lint",
+    "prettier": "prettier --write ."
  },
  "dependencies": {
    "@types/node": "18.16.0",
@@ -28,6 +29,7 @@
    "@tailwindcss/typography": "^0.5.9",
    "autoprefixer": "^10.4.14",
    "postcss": "^8.4.23",
+    "prettier": "2.8.8",
    "tailwindcss": "^3.3.1"
  }
 }
--- a/examples/github-backed-catalog/pages/@org/[org]/[...path].tsx
+++ b/examples/github-backed-catalog/pages/@org/[org]/[...path].tsx
@@ -1,22 +1,31 @@
-import { NextSeo } from 'next-seo';
-import { promises as fs } from 'fs';
-import path from 'path';
-import getConfig from 'next/config';
-import { getProject, GithubProject } from '../../../lib/octokit';
-import ReactMarkdown from 'react-markdown';
-import remarkGfm from 'remark-gfm';
-import Breadcrumbs from '../../../components/_shared/Breadcrumbs';
+import { NextSeo } from "next-seo";
+import { promises as fs } from "fs";
+import path from "path";
+import getConfig from "next/config";
+import { getProject, GithubProject } from "../../../lib/octokit";
+import ReactMarkdown from "react-markdown";
+import remarkGfm from "remark-gfm";
+import Breadcrumbs from "../../../components/_shared/Breadcrumbs";

 export default function ProjectPage({ project }) {
-  const repoId = `@${project.repo_config.owner}/${project.repo_config.repo}`
+  const repoId = `@${project.repo_config.owner}/${project.repo_config.repo}`;

  return (
    <>
-      <NextSeo title={`${repoId}${project.base_path !== '/' ? '/' + project.base_path : ''} - GitHub Datasets`} />
+      <NextSeo
+        title={`${repoId}${
+          project.base_path !== "/" ? "/" + project.base_path : ""
+        } - GitHub Datasets`}
+      />
      <main className="prose mx-auto my-8">
        <Breadcrumbs links={[{ title: repoId, href: "" }]} />
        <h1 className="mb-0 mt-16">{project.repo_config.name || repoId}</h1>
-        <p className='mb-8'><span className='font-semibold'>Repository:</span> <a target="_blank" href={project.html_url}>{project.html_url}</a></p>
+        <p className="mb-8">
+          <span className="font-semibold">Repository:</span>{" "}
+          <a target="_blank" href={project.html_url}>
+            {project.html_url}
+          </a>
+        </p>

        <h2 className="mb-0 mt-10">Files</h2>
        <div className="inline-block min-w-full py-2 align-middle">
@@ -54,7 +63,7 @@ export default function ProjectPage({ project }) {

        <hr />

-        <h2 className='uppercase font-black'>Readme</h2>
+        <h2 className="uppercase font-black">Readme</h2>
        <ReactMarkdown remarkPlugins={[remarkGfm]}>
          {project.readmeContent}
        </ReactMarkdown>
@@ -65,17 +74,14 @@ export default function ProjectPage({ project }) {

 // Generates `/posts/1` and `/posts/2`
 export async function getStaticPaths() {
-  const jsonDirectory = path.join(
-    process.cwd(),
-    'datasets.json'
-  );
-  const repos = await fs.readFile(jsonDirectory, 'utf8');
+  const jsonDirectory = path.join(process.cwd(), "datasets.json");
+  const repos = await fs.readFile(jsonDirectory, "utf8");

  return {
    paths: JSON.parse(repos).map((repo) => {
      const projectPath =
-        repo.readme.split('/').length > 1
-          ? repo.readme.split('/').slice(0, -1)
+        repo.readme && repo.readme.split("/").length > 1
+          ? repo.readme.split("/").slice(0, -1)
          : null;
      let path = [repo.repo];
      if (projectPath) {
@@ -92,16 +98,13 @@ export async function getStaticPaths() {
 }

 export async function getStaticProps({ params }) {
-  const jsonDirectory = path.join(
-    process.cwd(),
-    'datasets.json'
-  );
-  const reposFile = await fs.readFile(jsonDirectory, 'utf8');
+  const jsonDirectory = path.join(process.cwd(), "datasets.json");
+  const reposFile = await fs.readFile(jsonDirectory, "utf8");
  const repos: GithubProject[] = JSON.parse(reposFile);
  const repo = repos.find((_repo) => {
    const projectPath =
-      _repo.readme.split('/').length > 1
-        ? _repo.readme.split('/').slice(0, -1)
+      _repo.readme && _repo.readme.split("/").length > 1
+        ? _repo.readme.split("/").slice(0, -1)
        : null;
    let path = [_repo.repo];
    if (projectPath) {
--- a/examples/github-backed-catalog/pages/_app.tsx
+++ b/examples/github-backed-catalog/pages/_app.tsx
@@ -1,6 +1,6 @@
-import { AppProps } from 'next/app';
-import Head from 'next/head';
-import './styles.css';
+import { AppProps } from "next/app";
+import Head from "next/head";
+import "./styles.css";

 function CustomApp({ Component, pageProps }: AppProps) {
  return (
--- a/examples/github-backed-catalog/pages/index.tsx
+++ b/examples/github-backed-catalog/pages/index.tsx
@@ -1,21 +1,19 @@
-import { promises as fs } from 'fs';
-import path from 'path';
-import { getProject } from '../lib/octokit';
-import getConfig from 'next/config';
-import ExternalLinkIcon from '../components/icons/ExternalLinkIcon';
-import TimeAgo from 'react-timeago';
-import Link from 'next/link';
+import { promises as fs } from "fs";
+import path from "path";
+import { getProject } from "../lib/octokit";
+import getConfig from "next/config";
+import ExternalLinkIcon from "../components/icons/ExternalLinkIcon";
+import TimeAgo from "react-timeago";
+import Link from "next/link";
+import { NextSeo } from "next-seo";

 export async function getStaticProps() {
-  const jsonDirectory = path.join(
-    process.cwd(),
-    '/datasets.json'
-  );
-  const repos = await fs.readFile(jsonDirectory, 'utf8');
+  const jsonDirectory = path.join(process.cwd(), "/datasets.json");
+  const repos = await fs.readFile(jsonDirectory, "utf8");
  const github_pat = getConfig().serverRuntimeConfig.github_pat;

  const projects = await Promise.all(
-    (JSON.parse(repos)).map(async (repo) => {
+    JSON.parse(repos).map(async (repo) => {
      const project = await getProject(repo, github_pat);
      return { ...project, repo_config: repo };
    })
@@ -29,88 +27,112 @@ export async function getStaticProps() {

 export function Datasets({ projects }) {
  return (
-    <div className="bg-white min-h-screen">
-      <div className="mx-auto max-w-7xl px-6 py-16 sm:py-24 lg:px-8">
-        <div className='text-center'>
-          <h2 className="text-3xl font-bold leading-10 tracking-tight">
-            GitHub Datasets
-          </h2>
-          <p className="mt-3 mx-auto max-w-2xl text-base leading-7 text-gray-500">
-            Data catalog with datasets hosted on GitHub by <Link target="_blank" className='underline' href="https://portaljs.org/">🌀 PortalJS</Link>
-          </p>
-        </div>
-        <div className="mt-20">
-          <div className="-mx-4 -my-2 overflow-x-auto sm:-mx-6 lg:-mx-8">
-            <div className="inline-block min-w-full py-2 align-middle sm:px-6 lg:px-8">
-              <table className="min-w-full divide-y divide-gray-300">
-                <thead>
-                  <tr>
-                    <th
-                      scope="col"
-                      className="px-3 py-3.5 text-left text-sm font-semibold text-gray-900"
-                    >
-                      Name
-                    </th>
-                    <th
-                      scope="col"
-                      className="px-3 py-3.5 text-left text-sm font-semibold text-gray-900"
-                    >
-                      Repository
-                    </th>
-                    <th
-                      scope="col"
-                      className="px-3 py-3.5 text-left text-sm font-semibold text-gray-900"
-                    >
-                      Description
-                    </th>
-                    <th
-                      scope="col"
-                      className="px-3 py-3.5 text-left text-sm font-semibold text-gray-900"
-                    >
-                      Last updated
-                    </th>
-                    <th
-                      scope="col"
-                      className="relative py-3.5 pl-3 pr-4 sm:pr-0"
-                    ></th>
-                  </tr>
-                </thead>
-                <tbody className="divide-y divide-gray-200">
-                  {projects.map((project) => (
-                    <tr key={project.id}>
-                      <td className="whitespace-nowrap px-3 py-6 text-sm text-gray-500">
-                        {project.repo_config.name
-                          ? project.repo_config.name
-                          : project.full_name + (project.base_path === '/' ? '' : '/' + project.base_path)}
-                      </td>
-                      <td className="whitespace-nowrap px-3 py-6 text-sm group text-gray-500 hover:text-gray-900 transition-all duration-250">
-                        <a href={project.html_url} target="_blank" className='flex items-center'>@{project.full_name} <ExternalLinkIcon className='ml-1' /></a>
-                      </td>
-                      <td className="px-3 py-4 text-sm text-gray-500">
-                        {project.repo_config.description
-                          ? project.repo_config.description
-                          : project.description}
-                      </td>
-                      <td className="whitespace-nowrap px-3 py-6 text-sm text-gray-500">
-                        <TimeAgo date={new Date(project.last_updated)} />
-                      </td>
-                      <td className="relative whitespace-nowrap py-6 pl-3 pr-4 text-right text-sm font-medium sm:pr-0">
-                        <a
-                          href={`/@${project.repo_config.owner}/${project.repo_config.repo}/${project.base_path === '/' ? '' : project.base_path}`}
-                          className='border border-gray-900 text-gray-900 px-4 py-2 transition-all hover:bg-gray-900 hover:text-white'
-                        >
-                          info
-                        </a>
-                      </td>
+    <>
+      <NextSeo title="GitHub Datasets" />
+      <div className="bg-white min-h-screen">
+        <div className="mx-auto max-w-7xl px-6 py-16 sm:py-24 lg:px-8">
+          <div className="text-center">
+            <h2 className="text-3xl font-bold leading-10 tracking-tight">
+              GitHub Datasets
+            </h2>
+            <p className="mt-3 mx-auto max-w-2xl text-base leading-7 text-gray-500">
+              Data catalog with datasets hosted on GitHub by{" "}
+              <Link
+                target="_blank"
+                className="underline"
+                href="https://portaljs.org/"
+              >
+                🌀 PortalJS
+              </Link>
+            </p>
+          </div>
+          <div className="mt-20">
+            <div className="-mx-4 -my-2 overflow-x-auto sm:-mx-6 lg:-mx-8">
+              <div className="inline-block min-w-full py-2 align-middle sm:px-6 lg:px-8">
+                <table className="min-w-full divide-y divide-gray-300">
+                  <thead>
+                    <tr>
+                      <th
+                        scope="col"
+                        className="px-3 py-3.5 text-left text-sm font-semibold text-gray-900"
+                      >
+                        Name
+                      </th>
+                      <th
+                        scope="col"
+                        className="px-3 py-3.5 text-left text-sm font-semibold text-gray-900"
+                      >
+                        Repository
+                      </th>
+                      <th
+                        scope="col"
+                        className="px-3 py-3.5 text-left text-sm font-semibold text-gray-900"
+                      >
+                        Description
+                      </th>
+                      <th
+                        scope="col"
+                        className="px-3 py-3.5 text-left text-sm font-semibold text-gray-900"
+                      >
+                        Last updated
+                      </th>
+                      <th
+                        scope="col"
+                        className="relative py-3.5 pl-3 pr-4 sm:pr-0"
+                      ></th>
                    </tr>
-                  ))}
-                </tbody>
-              </table>
+                  </thead>
+                  <tbody className="divide-y divide-gray-200">
+                    {projects.map((project) => (
+                      <tr key={project.id}>
+                        <td className="whitespace-nowrap px-3 py-6 text-sm text-gray-500">
+                          {project.repo_config.name
+                            ? project.repo_config.name
+                            : project.full_name +
+                              (project.base_path === "/"
+                                ? ""
+                                : "/" + project.base_path)}
+                        </td>
+                        <td className="whitespace-nowrap px-3 py-6 text-sm group text-gray-500 hover:text-gray-900 transition-all duration-250">
+                          <a
+                            href={project.html_url}
+                            target="_blank"
+                            className="flex items-center"
+                          >
+                            @{project.full_name}{" "}
+                            <ExternalLinkIcon className="ml-1" />
+                          </a>
+                        </td>
+                        <td className="px-3 py-4 text-sm text-gray-500">
+                          {project.repo_config.description
+                            ? project.repo_config.description
+                            : project.description}
+                        </td>
+                        <td className="whitespace-nowrap px-3 py-6 text-sm text-gray-500">
+                          <TimeAgo date={new Date(project.last_updated)} />
+                        </td>
+                        <td className="relative whitespace-nowrap py-6 pl-3 pr-4 text-right text-sm font-medium sm:pr-0">
+                          <a
+                            href={`/@${project.repo_config.owner}/${
+                              project.repo_config.repo
+                            }/${
+                              project.base_path === "/" ? "" : project.base_path
+                            }`}
+                            className="border border-gray-900 text-gray-900 px-4 py-2 transition-all hover:bg-gray-900 hover:text-white"
+                          >
+                            info
+                          </a>
+                        </td>
+                      </tr>
+                    ))}
+                  </tbody>
+                </table>
+              </div>
            </div>
          </div>
        </div>
      </div>
-    </div>
+    </>
  );
 }

--- a/examples/github-backed-catalog/postcss.config.js
+++ b/examples/github-backed-catalog/postcss.config.js
@@ -3,4 +3,4 @@ module.exports = {
    tailwindcss: {},
    autoprefixer: {},
  },
-}
+};
--- a/examples/github-backed-catalog/tailwind.config.js
+++ b/examples/github-backed-catalog/tailwind.config.js
@@ -8,8 +8,5 @@ module.exports = {
  theme: {
    extend: {},
  },
-  plugins: [
-    require('@tailwindcss/typography')
-  ],
-}
-
+  plugins: [require("@tailwindcss/typography")],
+};
--- a/examples/openspending/tests/os-data.test.ts
+++ b/examples/openspending/tests/os-data.test.ts
@@ -0,0 +1,138 @@
+import { expect, test } from 'vitest';
+import { getAllProjectsFromOrg, getProjectDataPackage } from '../lib/project';
+import { loadDataPackage } from '../lib/loader';
+import { getProjectMetadata } from '../lib/project';
+import { getCsv, parseCsv } from '../components/Table';
+
+test(
+  'Test OS-Data',
+  async () => {
+    const repos = await getAllProjectsFromOrg(
+      'os-data',
+      'main',
+      process.env.VITE_GITHUB_PAT
+    );
+    if (repos.failed.length > 0) console.log(repos.failed);
+    expect(repos.failed.length).toBe(0);
+  },
+  { timeout: 100000 }
+);
+
+test(
+  'Test Gift-Data',
+  async () => {
+    const repos = await getAllProjectsFromOrg(
+      'gift-data',
+      'main',
+      process.env.VITE_GITHUB_PAT
+    );
+    if (repos.failed.length > 0) console.log(repos.failed);
+    expect(repos.failed.length).toBe(0);
+  },
+  { timeout: 100000 }
+);
+
+test(
+  'Test getting one dataset from github',
+  async () => {
+    const datapackage = await getProjectDataPackage(
+      'os-data',
+      'berlin-berlin',
+      'main',
+      process.env.VITE_GITHUB_PAT
+    );
+    const repo = await getProjectMetadata(
+      'os-data',
+      'berlin-berlin',
+      process.env.VITE_GITHUB_PAT
+    );
+    const project = loadDataPackage(datapackage, repo);
+    delete project['datapackage'];
+    delete project.files[0]['dialect'];
+    delete project.files[0]['schema'];
+    expect(project).toStrictEqual({
+      name: 'berlin-berlin',
+      title: 'Berlin-Berlin',
+      description: null,
+      owner: {
+        name: 'os-data',
+        logo: 'https://avatars.githubusercontent.com/u/13695166?v=4',
+        title: 'os-data',
+      },
+      repo: {
+        name: 'berlin-berlin',
+        full_name: 'os-data/berlin-berlin',
+        url: 'https://github.com/os-data/berlin-berlin',
+      },
+      files: [
+        {
+          name: 'berlin-gesamt',
+          format: 'csv',
+          path: 'https://storage.openspending.org/berlin-berlin/berlin-gesamt.csv',
+          mediatype: 'text/csv',
+          bytes: 81128743,
+          encoding: 'utf-8',
+        },
+      ],
+      author: 'Michael Peters <michael.peters@okfn.de>',
+      cityCode: 'Berlin',
+      countryCode: 'DE',
+      fiscalPeriod: { start: '2014-01-01', end: '2019-12-31' },
+      readme: '',
+    });
+  },
+  { timeout: 100000 }
+);
+
+test(
+  'Test getting one section of csv from R2',
+  async () => {
+    const rawCsv = await getCsv(
+      'https://storage.openspending.org/state-of-minas-gerais-brazil-planned-budget/__os_imported__br-mg-ppagloc.csv'
+    );
+    const parsedCsv = await parseCsv(rawCsv);
+    expect(parsedCsv.errors.length).toBe(1);
+    expect(parsedCsv.data.length).toBe(10165);
+    expect(parsedCsv.meta.fields).toStrictEqual([
+      'function_name',
+      'function_label',
+      'product_name',
+      'product_label',
+      'area_name',
+      'area_label',
+      'subaction_name',
+      'subaction_label',
+      'region_label_map',
+      'region_reg_map',
+      'region_name',
+      'region_label',
+      'municipality_map_id',
+      'municipality_name',
+      'municipality_map_code',
+      'municipality_label',
+      'municipality_map_name_simple',
+      'municipality_map_name',
+      'cofog1_label_en',
+      'cofog1_name',
+      'cofog1_label',
+      'amount',
+      'subprogramme_name',
+      'subprogramme_label',
+      'time_name',
+      'time_year',
+      'time_month',
+      'time_day',
+      'time_week',
+      'time_yearmonth',
+      'time_quarter',
+      'time',
+      'action_name',
+      'action_label',
+      'subfunction_name',
+      'subfunction_label',
+      'programme_name',
+      'programme_label',
+    ]);
+  },
+  { timeout: 100000 }
+);
--- a/examples/openspending/components/Button.tsx
+++ b/examples/openspending/components/Button.tsx
@@ -1,15 +1,15 @@
-import Link from 'next/link'
-import clsx from 'clsx'
+import Link from 'next/link';
+import clsx from 'clsx';

-export function Button({ href, className = "", ...props }) {
+export function Button({ href, className = '', ...props }) {
  className = clsx(
    'inline-flex justify-center rounded-2xl bg-emerald-600 p-4 text-base font-semibold text-white hover:bg-emerald-500 focus:outline-none focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-emerald-500 active:text-white/70',
    className
-  )
+  );

  return href ? (
-    <Link href={href} className={className} {...props} />
+    <Link scroll={false} href={href} className={className} {...props} />
  ) : (
    <button className={className} {...props} />
-  )
+  );
 }
--- a/examples/openspending/components/DatasetCard.tsx
+++ b/examples/openspending/components/DatasetCard.tsx
@@ -0,0 +1,76 @@
+import Link from 'next/link';
+import { Project } from '../lib/project.interface';
+import ExternalLinkIcon from './icons/ExternalLinkIcon';
+
+export default function DatasetCard({ dataset }: { dataset: Project }) {
+  return (
+    <div
+      key={dataset.name}
+      className="overflow-hidden rounded-xl border border-gray-200"
+    >
+      <Link
+        href={`/@${dataset.owner.name}/${dataset.repo.name}`}
+        className="flex items-center gap-x-4 border-b border-gray-900/5 bg-gray-50 p-6"
+      >
+        <img
+          src={dataset.owner.logo || '/assets/org-icon.svg'}
+          alt={dataset.owner.name}
+          className="h-12 w-12 flex-none rounded-lg bg-white object-cover ring-1 ring-gray-900/10 p-2"
+        />
+        <div className="text-sm font-medium leading-6">
+          <div className="text-gray-900 line-clamp-1">{dataset.title}</div>
+          <div className="text-gray-500 line-clamp-1">
+            {dataset.owner.title}
+          </div>
+        </div>
+      </Link>
+      <dl className="-my-3 divide-y divide-gray-100 px-6 py-4 text-sm leading-6">
+        <div className="flex justify-between gap-x-4 py-3">
+          <dt className="text-gray-500">Name</dt>
+          <dd className="flex items-start gap-x-2">
+            <div className="font-medium text-gray-900 line-clamp-1">
+              {dataset.name}
+            </div>
+          </dd>
+        </div>
+        <div className="flex justify-between gap-x-4 py-3">
+          <dt className="text-gray-500">Country</dt>
+          <dd className="flex items-start gap-x-2">
+            <div className="font-medium text-gray-900">
+              {dataset.countryCode}
+            </div>
+          </dd>
+        </div>
+        <div className="flex justify-between gap-x-4 py-3">
+          <dt className="text-gray-500">Fiscal Period</dt>
+          <dd className="text-gray-700">
+            {dataset.fiscalPeriod?.start &&
+              new Date(dataset.fiscalPeriod.start).getFullYear()}
+            {dataset.fiscalPeriod?.end &&
+              dataset.fiscalPeriod?.start !== dataset.fiscalPeriod?.end && (
+                <>
+                  {' - '}
+                  {new Date(dataset.fiscalPeriod.end).getFullYear()}
+                </>
+              )}
+          </dd>
+        </div>
+        <div className="flex justify-between gap-x-4 py-3">
+          <dt className="text-gray-500">Metadata</dt>
+          <dd className="flex items-start gap-x-2">
+            <div className="font-medium text-gray-900">
+              <Link
+                // TODO: this link may be incorrect for some datasets
+                href={`https://github.com/${dataset.owner.name}/${dataset.repo.name}/blob/main/datapackage.json`}
+                target="_blank"
+                className="flex items-center hover:text-gray-700"
+              >
+                datapackage.json <ExternalLinkIcon className="ml-1" />
+              </Link>
+            </div>
+          </dd>
+        </div>
+      </dl>
+    </div>
+  );
+}
--- a/examples/openspending/components/DatasetsGrid.tsx
+++ b/examples/openspending/components/DatasetsGrid.tsx
@@ -0,0 +1,19 @@
+import { Project } from '../lib/project.interface';
+import DatasetCard from './DatasetCard';
+
+export default function DatasetsGrid({ datasets }: { datasets: Project[] }) {
+  return (
+    <ul
+      className="grid gap-x-6 gap-y-8 grid-cols-1 sm:grid-cols-2 md:grid-cols-3"
+      role="list"
+    >
+      {datasets.map((dataset, idx) => {
+        return (
+          <li key={`datasets-grid-item-${idx}`}>
+            <DatasetCard dataset={dataset} />
+          </li>
+        );
+      })}
+    </ul>
+  );
+}
--- a/examples/openspending/components/DatasetsSearch.tsx
+++ b/examples/openspending/components/DatasetsSearch.tsx
@@ -0,0 +1,225 @@
+import { useForm } from 'react-hook-form';
+import DatasetsGrid from './DatasetsGrid';
+import { Project } from '../lib/project.interface';
+import { Index } from 'flexsearch';
+import {
+  ChevronDoubleLeftIcon,
+  ChevronDoubleRightIcon,
+  ChevronLeftIcon,
+  ChevronRightIcon,
+} from '@heroicons/react/24/solid';
+import { useState } from 'react';
+
+export default function DatasetsSearch({
+  datasets,
+  availableCountries,
+}: {
+  datasets: Project[];
+  availableCountries;
+}) {
+  const itemsPerPage = 6;
+  const [page, setPage] = useState(1);
+
+  const index = new Index({ tokenize: 'full' });
+
+  datasets.forEach((dataset: Project) =>
+    index.add(
+      dataset.name,
+      `${dataset.repo} ${dataset.name} ${dataset.title} ${dataset.author} ${dataset.title} ${dataset.cityCode} ${dataset.fiscalPeriod?.start} ${dataset.fiscalPeriod?.end}`
+    )
+  );
+
+  const { register, watch, handleSubmit, reset, resetField } = useForm({
+    defaultValues: {
+      searchTerm: '',
+      country: '',
+      minDate: '',
+      maxDate: '',
+    },
+  });
+
+  const filteredDatasets = datasets
+    .filter((dataset: Project) =>
+      watch().searchTerm && watch().searchTerm !== ''
+        ? index.search(watch().searchTerm).includes(dataset.name)
+        : true
+    )
+    .filter((dataset) =>
+      watch().country && watch().country !== ''
+        ? dataset.countryCode === watch().country
+        : true
+    )
+    .filter((dataset) => {
+      const filterMinDate = watch().minDate;
+      const filterMaxDate = watch().maxDate;
+
+      const datasetMinDate = dataset.fiscalPeriod?.start;
+      const datasetMaxDate = dataset.fiscalPeriod?.end;
+
+      let datasetStartOverlaps = false;
+      if (datasetMinDate) {
+        datasetStartOverlaps =
+          datasetMinDate >= filterMinDate && datasetMinDate <= filterMaxDate;
+      }
+
+      let datasetEndOverlaps = false;
+      if (datasetMaxDate) {
+        datasetEndOverlaps =
+          datasetMaxDate >= filterMinDate && datasetMaxDate <= filterMaxDate;
+      }
+
+      if (filterMinDate && filterMaxDate) {
+        return datasetStartOverlaps || datasetEndOverlaps;
+      } else if (filterMinDate) {
+        return datasetMinDate >= filterMinDate;
+      } else if (filterMaxDate) {
+        return datasetMinDate <= filterMaxDate;
+      }
+
+      return true;
+    });
+
+  const paginatedDatasets = filteredDatasets.slice(
+    (page - 1) * itemsPerPage,
+    (page - 1) * itemsPerPage + itemsPerPage
+  );
+
+  const pageCount = Math.ceil(filteredDatasets.length / itemsPerPage) || 1;
+
+  return (
+    <>
+      <div className="flex flex-col gap-3 sm:flex-row">
+        <div className="min-w-0 flex-auto">
+          <br />
+          <div className="relative">
+            <input
+              placeholder="Search datasets"
+              aria-label="Search datasets"
+              {...register('searchTerm', { onChange: () => setPage(1) })}
+              className="h-[3em] relative w-full rounded-lg bg-white py-2 pl-3 pr-10 text-left shadow-md focus:outline-none focus-visible:border-emerald-500 focus-visible:ring-2 focus-visible:ring-white focus-visible:ring-opacity-75 focus-visible:ring-offset-2 focus-visible:ring-offset-emerald-400 sm:text-sm"
+            />
+            {watch().searchTerm !== '' && (
+              <button
+                onClick={() => resetField('searchTerm')}
+                className="absolute right-3 top-1/2 -translate-y-1/2 text-gray-500"
+              >
+                <CloseIcon />
+              </button>
+            )}
+          </div>
+        </div>
+        <div className="sm:basis-1/6">
+          {/* TODO: nicer select e.g. headlessui example */}
+          <label className="text-sm text-gray-600 font-medium">Country</label>
+          <select
+            className="h-[3em] w-full rounded-lg bg-white py-2 pl-3 pr-10 text-left shadow-md focus:outline-none focus-visible:border-emerald-500 focus-visible:ring-2 focus-visible:ring-white focus-visible:ring-opacity-75 focus-visible:ring-offset-2 focus-visible:ring-offset-emerald-400 sm:text-sm"
+            {...register('country', { onChange: () => setPage(1) })}
+          >
+            <option value="">All</option>
+            {availableCountries.map((country) => {
+              return (
+                <option key={country.code} value={country.code}>
+                  {country.title}
+                </option>
+              );
+            })}
+          </select>
+        </div>
+        <div className="sm:basis-1/6">
+          <label className="text-sm text-gray-600 font-medium">
+            Fiscal Period Start
+          </label>
+          <div className="relative">
+            <input
+              aria-label="Min. date"
+              type="date"
+              {...register('minDate', { onChange: () => setPage(1) })}
+              className="h-[3em] w-full rounded-lg bg-white py-2 pl-3 pr-10 text-left shadow-md focus:outline-none focus-visible:border-emerald-500 focus-visible:ring-2 focus-visible:ring-white focus-visible:ring-opacity-75 focus-visible:ring-offset-2 focus-visible:ring-offset-emerald-400 sm:text-sm"
+            />
+          </div>
+        </div>
+        <div className="sm:basis-1/6">
+          <label className="text-sm text-gray-600 font-medium">
+            Fiscal Period End
+          </label>
+          <div className="relative">
+            <input
+              aria-label="Max. date"
+              type="date"
+              {...register('maxDate', { onChange: () => setPage(1) })}
+              className="h-[3em] w-full rounded-lg bg-white py-2 pl-3 pr-10 text-left shadow-md focus:outline-none focus-visible:border-emerald-500 focus-visible:ring-2 focus-visible:ring-white focus-visible:ring-opacity-75 focus-visible:ring-offset-2 focus-visible:ring-offset-emerald-400 sm:text-sm"
+            />
+          </div>
+        </div>
+      </div>
+      <div className="mt-5 mb-5">
+        <span className="text-lg font-medium">
+          {filteredDatasets.length} datasets found
+        </span>
+      </div>
+      <div className="min-w-full align-middle">
+        <DatasetsGrid datasets={paginatedDatasets} />
+        <div className="w-full flex justify-center mt-10">
+          <button
+            onClick={() => setPage(1)}
+            disabled={page <= 1}
+            className="disabled:text-gray-400"
+          >
+            <ChevronDoubleLeftIcon className="w-6 h-6" />
+          </button>
+          <button
+            onClick={() => {
+              if (page > 1) setPage((prev) => --prev);
+            }}
+            disabled={page <= 1}
+            className="disabled:text-gray-400"
+          >
+            <ChevronLeftIcon className="w-6 h-6" />
+          </button>
+          <span className="mx-5">
+            Page {page} of {pageCount}
+          </span>
+          <button
+            onClick={() => {
+              if (page < pageCount) setPage((prev) => ++prev);
+            }}
+            disabled={page >= pageCount}
+            className="disabled:text-gray-400"
+          >
+            <ChevronRightIcon className="w-6 h-6" />
+          </button>
+          <button
+            onClick={() => setPage(pageCount)}
+            disabled={page >= pageCount}
+            className="disabled:text-gray-400"
+          >
+            <ChevronDoubleRightIcon className="w-6 h-6" />
+          </button>
+        </div>
+      </div>
+    </>
+  );
+}
+
+const CloseIcon = () => {
+  return (
+    <svg
+      width={20}
+      height={20}
+      viewBox="0 0 24 24"
+      fill="none"
+      xmlns="http://www.w3.org/2000/svg"
+    >
+      <g id="Menu / Close_MD">
+        <path
+          id="Vector"
+          d="M18 18L12 12M12 12L6 6M12 12L18 6M12 12L6 18"
+          stroke="currentColor"
+          strokeWidth="2"
+          strokeLinecap="round"
+          strokeLinejoin="round"
+        />
+      </g>
+    </svg>
+  );
+};
--- a/examples/openspending/components/FlatUiTable.tsx
+++ b/examples/openspending/components/FlatUiTable.tsx
@@ -0,0 +1,94 @@
+import {
+  QueryClient,
+  QueryClientProvider,
+  useQuery,
+  useQueryClient,
+} from 'react-query';
+import Papa from 'papaparse';
+import { Grid } from '@githubocto/flat-ui';
+
+const queryClient = new QueryClient();
+
+export async function getCsv(url: string) {
+  const response = await fetch(url, {
+    headers: {
+      Range: 'bytes=0-5132288',
+    },
+  });
+  const data = await response.text();
+  return data;
+}
+
+export async function parseCsv(file: string): Promise<any> {
+  return new Promise((resolve, reject) => {
+    Papa.parse(file, {
+      header: true,
+      dynamicTyping: true,
+      skipEmptyLines: true,
+      transform: (value: string): string => {
+        return value.trim();
+      },
+      complete: (results: any) => {
+        return resolve(results);
+      },
+      error: (error: any) => {
+        return reject(error);
+      },
+    });
+  });
+}
+
+const Spinning = () => {
+  return (
+    <div role="status w-fit mx-auto">
+      <svg
+        aria-hidden="true"
+        className="w-8 h-8 mr-2 text-gray-200 animate-spin dark:text-gray-600 fill-emerald-600"
+        viewBox="0 0 100 101"
+        fill="none"
+        xmlns="http://www.w3.org/2000/svg"
+      >
+        <path
+          d="M100 50.5908C100 78.2051 77.6142 100.591 50 100.591C22.3858 100.591 0 78.2051 0 50.5908C0 22.9766 22.3858 0.59082 50 0.59082C77.6142 0.59082 100 22.9766 100 50.5908ZM9.08144 50.5908C9.08144 73.1895 27.4013 91.5094 50 91.5094C72.5987 91.5094 90.9186 73.1895 90.9186 50.5908C90.9186 27.9921 72.5987 9.67226 50 9.67226C27.4013 9.67226 9.08144 27.9921 9.08144 50.5908Z"
+          fill="currentColor"
+        />
+        <path
+          d="M93.9676 39.0409C96.393 38.4038 97.8624 35.9116 97.0079 33.5539C95.2932 28.8227 92.871 24.3692 89.8167 20.348C85.8452 15.1192 80.8826 10.7238 75.2124 7.41289C69.5422 4.10194 63.2754 1.94025 56.7698 1.05124C51.7666 0.367541 46.6976 0.446843 41.7345 1.27873C39.2613 1.69328 37.813 4.19778 38.4501 6.62326C39.0873 9.04874 41.5694 10.4717 44.0505 10.1071C47.8511 9.54855 51.7191 9.52689 55.5402 10.0491C60.8642 10.7766 65.9928 12.5457 70.6331 15.2552C75.2735 17.9648 79.3347 21.5619 82.5849 25.841C84.9175 28.9121 86.7997 32.2913 88.1811 35.8758C89.083 38.2158 91.5421 39.6781 93.9676 39.0409Z"
+          fill="currentFill"
+        />
+      </svg>
+      <span className="sr-only">Loading...</span>
+    </div>
+  );
+};
+
+export const FlatUiTable: React.FC<{ url: string }> = ({ url }) => {
+  return (
+    // Provide the client to your App
+    <QueryClientProvider client={queryClient}>
+      <TableInner url={url} />
+    </QueryClientProvider>
+  );
+};
+
+const TableInner: React.FC<{ url: string }> = ({ url }) => {
+  const { data: csvString, isLoading: isDownloadingCSV } = useQuery(
+    ['dataCsv', url],
+    () => getCsv(url)
+  );
+  const { data: parsedData, isLoading: isParsing } = useQuery(
+    ['dataPreview', csvString],
+    () => parseCsv(csvString),
+    { enabled: !!csvString }
+  );
+  if (isParsing || isDownloadingCSV)
+    <div className="w-full">
+      <Spinning />
+    </div>;
+  if (parsedData)
+    return (
+      <div className="h-[500px] w-full">
+        <Grid data={parsedData.data} />
+      </div>
+    );
+};
--- a/examples/openspending/components/Header.tsx
+++ b/examples/openspending/components/Header.tsx
@@ -1,54 +1,82 @@
-import Image from 'next/image'
-import { Button } from './Button'
-import { Container } from './Container'
-import logo from "../public/logo.svg"
-import Link from 'next/link'
-import { useRouter } from 'next/router'
+import Image from 'next/image';
+import { Container } from './Container';
+import logo from '../public/logo.svg';
+import Link from 'next/link';
+import { useRouter } from 'next/router';
+import { Bars3Icon } from '@heroicons/react/24/outline';
+import { useState } from 'react';

 export function Header() {
+  const [menuOpen, setMenuOpen] = useState<boolean>(false);
+
  const router = useRouter();

  const isActive = (navLink) => {
-    return router.asPath.split("?")[0] == navLink.href;
-  }
+    return router.asPath.split('?')[0] == navLink.href;
+  };

  const navLinks = [
    {
-      title: "Home",
-      href: "/#header"
+      title: 'Home',
+      href: '/',
    },
    {
-      title: "Datasets",
-      href: "/#datasets"
+      title: 'Datasets',
+      href: '/#datasets',
    },
-    {
-      title: "Community",
-      href: "https://community.openspending.org/"
-    }
-  ]
+    // {
+    //   title: "Community",
+    //   href: "https://community.openspending.org/"
+    // }
+  ];

  return (
-    <header className="z-50 pb-5 lg:pt-11 sticky top-0 backdrop-blur" id="header">
-      <Container className="flex flex-wrap items-center justify-center sm:justify-between lg:flex-nowrap">
-        <div className="mt-10 lg:mt-0 lg:grow lg:basis-0 flex items-center">
+    <header className="relative z-50 pb-11 lg:pt-11">
+      <Container className="flex flex-wrap items-center justify-between lg:flex-nowrap mt-10 lg:mt-0">
+        <Link href="/" className="lg:mt-0 lg:grow lg:basis-0 flex items-center">
          <Image src={logo} alt="OpenSpending" className="h-12 w-auto" />
-        </div>
-        <ul className='list-none flex gap-x-5 text-base font-medium'>
+        </Link>
+        <ul className="hidden list-none sm:flex gap-x-5 text-base font-medium">
          {navLinks.map((link, i) => (
            <li key={`nav-link-${i}`}>
              <Link
-                className={`text-emerald-900 hover:text-emerald-600 ${isActive(link) ? "text-emerald-600" : ""}`}
+                className={`text-emerald-900 hover:text-emerald-600 ${
+                  isActive(link) ? 'text-emerald-600' : ''
+                }`}
                href={link.href}
                scroll={false}
              >
                {link.title}
              </Link>
-            </li>))}
+            </li>
+          ))}
        </ul>
-        <div className="hidden sm:mt-10 sm:flex lg:mt-0 lg:grow lg:basis-0 lg:justify-end">
-          <Button href="#">View on GitHub</Button>
+        <div className="hidden xl:block xl:grow"></div>
+        <div className="sm:hidden sm:mt-10 lg:mt-0 lg:grow lg:basis-0 lg:justify-end">
+          <button onClick={() => setMenuOpen(!menuOpen)}>
+            <Bars3Icon className="w-8 h-8" />
+          </button>
        </div>
+        {menuOpen && (
+          <div className={`sm:hidden basis-full mt-5 text-center`}>
+            <ul className="gap-x-5 text-base font-medium">
+              {navLinks.map((link, i) => (
+                <li key={`nav-link-${i}`}>
+                  <Link
+                    className={`text-emerald-900 hover:text-emerald-600 ${
+                      isActive(link) ? 'text-emerald-600' : ''
+                    }`}
+                    href={link.href}
+                    scroll={false}
+                  >
+                    {link.title}
+                  </Link>
+                </li>
+              ))}
+            </ul>
+          </div>
+        )}
      </Container>
-    </header >
-  )
+    </header>
+  );
 }
--- a/examples/openspending/components/Hero.tsx
+++ b/examples/openspending/components/Hero.tsx
@@ -1,9 +1,9 @@
-import { Button } from './Button'
-import { Container } from './Container'
+import { Button } from './Button';
+import { Container } from './Container';

-export function Hero() {
+export function Hero({ countriesCount, datasetsCount, filesCount }) {
  return (
-    <div className="relative pb-20 pt-10 sm:py-40">
+    <div className="relative pb-20 pt-10 sm:py-40" id="hero">
      <div className="absolute inset-x-0 -bottom-14 -top-48 overflow-hidden bg-green-50 bg-opacity-50">
        <div className="absolute inset-x-0 top-0 h-40 bg-gradient-to-b from-white" />
        <div className="absolute inset-x-0 bottom-0 h-40 bg-gradient-to-t from-white" />
@@ -15,22 +15,25 @@ export function Hero() {
          </h1>
          <div className="mt-6 space-y-6 font-display text-2xl tracking-tight text-emerald-900">
            <p>
-              By understanding how governments spend money in our name can we have a say
-              in how that money will affect our own lives. The journey starts here.
+              By understanding how governments spend money in our name can we
+              have a say in how that money will affect our own lives. The
+              journey starts here.
            </p>
            <p>
-              OpenSpending is a free, open and global platform to search, visualise and analyse
-              fiscal data in the public sphere.
+              OpenSpending is a free, open and global platform to search,
+              visualise and analyse fiscal data in the public sphere.
            </p>
          </div>
-          <Button href="#" className="mt-10 w-full sm:hidden">
-            View on GitHub
+          <Button href="#datasets" className="mt-10">
+            Search datasets
          </Button>
          <dl className="mt-10 grid grid-cols-2 gap-x-10 gap-y-6 sm:mt-16 sm:gap-x-16 sm:gap-y-10 sm:text-center lg:auto-cols-auto lg:grid-flow-col lg:grid-cols-none lg:justify-start lg:text-left">
            {[
-              ['Countries', '75'],
-              ['Datasets', '2091'],
-              ['Files', '9230'],
+              //  Added the plus sign because some datasets do not
+              //  contain defined countries
+              ['Countries', '+' + countriesCount],
+              ['Datasets', datasetsCount],
+              ['Files', filesCount],
            ].map(([name, value]) => (
              <div key={name}>
                <dt className="font-mono text-sm text-emerald-600">{name}</dt>
@@ -43,5 +46,5 @@ export function Hero() {
        </div>
      </Container>
    </div>
-  )
+  );
 }
--- a/examples/openspending/components/_shared/Layout.tsx
+++ b/examples/openspending/components/_shared/Layout.tsx
@@ -0,0 +1,10 @@
+import { Header } from '../Header';
+
+export default function Layout({ children }) {
+  return (
+    <div className="bg-white min-h-screen pb-32">
+      <Header />
+      {children}
+    </div>
+  );
+}
--- a/examples/openspending/datasets.json
+++ b/examples/openspending/datasets.json
@@ -1,25 +0,0 @@
-[
-  {
-    "owner": "os-data",
-    "branch": "main",
-    "repo": "mongolia-budget-2016-2017",
-    "files": [
-      "data/mongolia-2017.csv",
-      "data/mongolia-2017__2017.csv"
-    ]
-  },
-  {
-    "owner": "os-data",
-    "branch": "main",
-    "repo": "gb-country-regional-analysis",
-    "files": [
-      "data/cofog.csv",
-      "data/cofog_dejargonise.csv",
-      "data/cra.csv",
-      "data/departments.csv",
-      "data/nuts_pop.csv",
-      "data/pogs.csv"
-    ],
-    "readme": "README.md"
-  }
-]
--- a/examples/openspending/lib/datapackage.interface.ts
+++ b/examples/openspending/lib/datapackage.interface.ts
@@ -0,0 +1,289 @@
+/**
+ * Fiscal Data Package is a simple specification for data access and delivery of fiscal data.
+ */
+export type FiscalDataPackage = TabularDataPackage & {
+  countryCode?: ISO31661Alpha2CountryCode
+  regionCode?: string
+  cityCode?: string
+  author?: string
+  readme?: string
+  granularity?: GranularityOfResources
+  fiscalPeriod?: FiscalPeriodForTheBudget
+  [k: string]: unknown
+}
+/**
+ * The profile of this descriptor.
+ */
+export type Profile = "tabular-data-package"
+/**
+ * An identifier string. Lower case characters with `.`, `_`, `-` and `/` are allowed.
+ */
+export type Name = string
+/**
+ * A property reserved for globally unique identifiers. Examples of identifiers that are unique include UUIDs and DOIs.
+ */
+export type ID = string
+/**
+ * A human-readable title.
+ */
+export type Title = string
+/**
+ * A text description. Markdown is encouraged.
+ */
+export type Description = string
+/**
+ * The home on the web that is related to this data package.
+ */
+export type HomePage = string
+/**
+ * The datetime on which this descriptor was created.
+ */
+export type Created = string
+/**
+ * The contributors to this descriptor.
+ */
+export type Contributors = [Contributor, ...Contributor[]]
+/**
+ * A human-readable title.
+ */
+export type Title1 = string
+/**
+ * A fully qualified URL, or a POSIX file path.
+ */
+export type Path = string
+/**
+ * An email address.
+ */
+export type Email = string
+/**
+ * An organizational affiliation for this contributor.
+ */
+export type Organization = string
+/**
+ * A list of keywords that describe this package.
+ */
+export type Keywords = [string, ...string[]]
+/**
+ * A image to represent this package.
+ */
+export type Image = string
+/**
+ * The license(s) under which this package is published.
+ */
+export type Licenses = [License, ...License[]]
+/**
+ * A license for this descriptor.
+ */
+export type License =
+  | {
+      [k: string]: unknown
+    }
+  | {
+      [k: string]: unknown
+    }
+/**
+ * An `array` of Tabular Data Resource objects, each compliant with the [Tabular Data Resource](/tabular-data-resource/) specification.
+ *
+/**
+ * A Tabular Data Resource.
+ */
+export interface TabularDataResource {
+  format?: string;
+  name: string;
+  description?: string;
+  title?: string;
+  schema?: Schema;
+  sample?: any[];
+  profile?: string;
+  key?: string;
+  path?: string;
+  size?: number;
+  bytes?: number;
+}
+
+export interface Field {
+  name: string;
+  type: FieldType;
+}
+
+export interface Schema {
+  fields: Field[];
+}
+
+export const OptionsFields = [
+  "any",
+  "array",
+  "boolean",
+  "date",
+  "datetime",
+  "duration",
+  "geojson",
+  "geopoint",
+  "integer",
+  "number",
+  "object",
+  "string",
+  "time",
+  "year",
+  "yearmonth",
+] as const;
+
+type FieldType = typeof OptionsFields[number];
+/**
+ * A human-readable title.
+ */
+export type Title2 = string
+/**
+ * A fully qualified URL, or a POSIX file path.
+ */
+export type Path1 = string
+/**
+ * An email address.
+ */
+export type Email1 = string
+/**
+ * The raw sources for this resource.
+ */
+export type Sources = Source[]
+
+/**
+ * A keyword that represents the direction of the spend, either expenditure or revenue.
+ */
+export type DirectionOfTheSpending = "expenditure" | "revenue"
+/**
+ * A keyword that represents the phase of the data, can be proposed for a budget proposal, approved for an approved budget, adjusted for modified budget or executed for the enacted budget
+ */
+export type BudgetPhase = "proposed" | "approved" | "adjusted" | "executed"
+/**
+ * Either an array of strings corresponding to the name attributes in a set of field objects in the fields array or a single string corresponding to one of these names. The value of primaryKey indicates the primary key or primary keys for the dimension.
+ */
+export type PrimaryKey = string | [string, ...string[]]
+/**
+ * Describes what kind of a dimension it is.
+ */
+export type DimensionType =
+  | "datetime"
+  | "entity"
+  | "classification"
+  | "activity"
+  | "fact"
+  | "location"
+  | "other"
+/**
+ * The type of the classification.
+ */
+export type ClassificationType = "functional" | "administrative" | "economic"
+/**
+ * A valid 2-digit ISO country code (ISO 3166-1 alpha-2), or, an array of valid ISO codes.
+ */
+export type ISO31661Alpha2CountryCode = string | [string, ...string[]]
+/**
+ * A keyword that represents the type of spend data, eiter aggregated or transactional
+ */
+export type GranularityOfResources = "aggregated" | "transactional"
+
+/**
+ * Tabular Data Package
+ */
+export interface TabularDataPackage {
+  profile: Profile
+  name?: Name
+  id?: ID
+  title?: Title
+  description?: Description
+  homepage?: HomePage
+  created?: Created
+  contributors?: Contributors
+  keywords?: Keywords
+  image?: Image
+  licenses?: Licenses
+  resources: TabularDataResource[]
+  sources?: Sources
+  [k: string]: unknown
+}
+/**
+ * A contributor to this descriptor.
+ */
+export interface Contributor {
+  title: Title1
+  path?: Path
+  email?: Email
+  organization?: Organization
+  role?: string
+  [k: string]: unknown
+}
+/**
+ * A source file.
+ */
+export interface Source {
+  title: Title2
+  path?: Path1
+  email?: Email1
+  [k: string]: unknown
+}
+/**
+ * Measures are numerical and correspond to financial amounts in the source data.
+ */
+export interface Measures {
+  [k: string]: Measure
+}
+/**
+ * Measure.
+ *
+ * This interface was referenced by `Measures`'s JSON-Schema definition
+ * via the `patternProperty` "^\w+".
+ */
+export interface Measure {
+  source: string
+  resource?: string
+  currency: string
+  factor?: number
+  direction?: DirectionOfTheSpending
+  phase?: BudgetPhase
+  [k: string]: unknown
+}
+/**
+ * Dimensions are groups of related fields. Dimensions cover all items other than the measure.
+ */
+export interface Dimensions {
+  [k: string]: Dimension
+}
+/**
+ * Dimension.
+ *
+ * This interface was referenced by `Dimensions`'s JSON-Schema definition
+ * via the `patternProperty` "^\w+".
+ */
+export interface Dimension {
+  attributes: Attributes
+  primaryKey: PrimaryKey
+  dimensionType?: DimensionType
+  classificationType?: ClassificationType
+  [k: string]: unknown
+}
+/**
+ * Attribute objects that make up the dimension
+ */
+export interface Attributes {
+  /**
+   * This interface was referenced by `Attributes`'s JSON-Schema definition
+   * via the `patternProperty` "^\w+".
+   */
+  [k: string]: {
+    source: string
+    resource?: string
+    constant?: string | number
+    parent?: string
+    labelfor?: string
+    [k: string]: unknown
+  }
+}
+/**
+ * The fiscal period of the dataset
+ */
+export interface FiscalPeriodForTheBudget {
+  start: string
+  end?: string
+  [k: string]: unknown
+}
+
--- a/examples/openspending/lib/loader.ts
+++ b/examples/openspending/lib/loader.ts
@@ -0,0 +1,35 @@
+import { FiscalDataPackage } from './datapackage.interface';
+import { Project } from './project.interface';
+
+export function loadDataPackage(datapackage: FiscalDataPackage, repo): Project {
+  return {
+    name: datapackage.name,
+    title: datapackage.title,
+    description: datapackage.description || null,
+    owner: {
+      name: repo.owner.login,
+      logo: repo.owner.avatar_url,
+      // TODO: make this title work
+      title: repo.owner.login,
+    },
+    repo: { name: repo.name, full_name: repo.full_name, url: repo.html_url },
+    files: datapackage.resources,
+    author: datapackage.author ? datapackage.author : null,
+    cityCode: datapackage.cityCode ? datapackage.cityCode : null,
+    countryCode: datapackage.countryCode
+      ? (datapackage.countryCode as string)
+      : null,
+    fiscalPeriod: datapackage.fiscalPeriod
+      ? {
+          start: datapackage.fiscalPeriod.start
+            ? datapackage.fiscalPeriod.start
+            : null,
+          end: datapackage.fiscalPeriod.end
+            ? datapackage.fiscalPeriod.end
+            : null,
+        }
+      : null,
+    readme: datapackage.readme ? datapackage.readme : '',
+    datapackage,
+  };
+}
--- a/examples/openspending/lib/project.interface.ts
+++ b/examples/openspending/lib/project.interface.ts
@@ -0,0 +1,22 @@
+import {
+  FiscalDataPackage,
+  TabularDataResource,
+} from './datapackage.interface';
+
+export interface Project {
+  owner: { name: string; logo?: string; title?: string }; // Info about the owner of the data repo
+  repo: { name: string; full_name: string; url: string }; // Info about the the data repo
+  files: TabularDataResource[];
+  name: string;
+  title?: string;
+  description?: string;
+  author?: string;
+  cityCode?: string;
+  countryCode?: string;
+  fiscalPeriod?: {
+    start: string;
+    end: string;
+  };
+  readme?: string;
+  datapackage: FiscalDataPackage;
+}
--- a/examples/openspending/lib/project.ts
+++ b/examples/openspending/lib/project.ts
@@ -13,8 +13,7 @@ export interface GithubProject {
 export async function getProjectReadme(
  owner: string,
  repo: string,
-  branch: string,
-  readme: string,
+  branch: string = 'main',
  github_pat?: string
 ) {
  const octokit = new Octokit({ auth: github_pat });
@@ -22,7 +21,7 @@ export async function getProjectReadme(
    const response = await octokit.rest.repos.getContent({
      owner,
      repo,
-      path: readme,
+      path: 'README.md',
      ref: branch,
    });
    const data = response.data as { content?: string };
@@ -125,7 +124,6 @@ export async function getProject(project: GithubProject, github_pat?: string) {
    project.owner,
    project.repo,
    project.branch,
-    project.readme,
    github_pat
  );

@@ -140,7 +138,8 @@ export async function getProject(project: GithubProject, github_pat?: string) {
    return null;
  }

-  let projectBase = "", last_updated = "";
+  let projectBase = '',
+    last_updated = '';
  if (projectReadme) {
    projectBase =
      project.readme.split('/').length > 1
@@ -162,3 +161,65 @@ export async function getProject(project: GithubProject, github_pat?: string) {
    base_path: projectBase,
  };
 }
+
+export async function getProjectDataPackage(
+  owner: string,
+  repo: string,
+  branch: string,
+  github_pat?: string
+) {
+  const octokit = new Octokit({ auth: github_pat });
+  try {
+    const response = await octokit.rest.repos.getContent({
+      owner,
+      repo,
+      path: 'datapackage.json',
+      ref: branch,
+    });
+    const data = response.data as { content?: string };
+    const fileContent = data.content ? data.content : '';
+    if (fileContent === '') {
+      return null;
+    }
+    const decodedContent = Buffer.from(fileContent, 'base64').toString();
+    const datapackage = JSON.parse(decodedContent);
+
+    return { ...datapackage, repo };
+  } catch (error) {
+    return null;
+  }
+}
+
+export async function getAllProjectsFromOrg(
+  org: string,
+  branch?: string,
+  github_pat?: string
+) {
+  const octokit = new Octokit({ auth: github_pat });
+  const repos = await octokit.rest.repos.listForOrg({
+    org,
+    type: 'public',
+    per_page: 100,
+  });
+  let failedProjects = [];
+  const projects = await Promise.all(
+    repos.data.map(async (_repo) => {
+      const project = await getProjectDataPackage(
+        org,
+        _repo.name,
+        branch ? branch : 'main',
+        github_pat
+      );
+      if (!project) {
+        failedProjects.push(_repo.name);
+        return null;
+      }
+
+      return { datapackage: project, repo: _repo };
+    })
+  );
+  return {
+    results: projects.filter((item) => item !== null),
+    failed: failedProjects,
+  };
+}
--- a/examples/openspending/orgs.json
+++ b/examples/openspending/orgs.json
@@ -0,0 +1,3 @@
+[
+ "os-data"
+]
--- a/examples/openspending/package-lock.json
+++ b/examples/openspending/package-lock.json
--- a/examples/openspending/package.json
+++ b/examples/openspending/package.json
@@ -6,30 +6,42 @@
    "dev": "next dev",
    "build": "next build",
    "start": "next start",
-    "lint": "next lint"
+    "lint": "next lint",
+    "test": "vitest"
  },
  "dependencies": {
+    "@githubocto/flat-ui": "^0.14.1",
+    "@heroicons/react": "^2.0.18",
+    "@octokit/plugin-throttling": "^5.2.2",
+    "@types/flexsearch": "^0.7.3",
    "@types/node": "18.16.0",
    "@types/react": "18.0.38",
    "@types/react-dom": "18.0.11",
+    "@vitejs/plugin-react": "^4.0.0",
    "clsx": "^1.2.1",
    "eslint": "8.39.0",
    "eslint-config-next": "13.3.1",
+    "flexsearch": "0.7.21",
    "next": "13.3.1",
    "next-seo": "^6.0.0",
    "octokit": "^2.0.14",
+    "papaparse": "^5.4.1",
    "prettier": "^2.8.8",
    "react": "18.2.0",
    "react-dom": "18.2.0",
+    "react-hook-form": "^7.43.9",
    "react-markdown": "^8.0.7",
+    "react-query": "^3.39.3",
    "react-timeago": "^7.1.0",
    "remark-gfm": "^3.0.1",
    "typescript": "5.0.4"
  },
  "devDependencies": {
    "@tailwindcss/typography": "^0.5.9",
+    "@types/papaparse": "^5.3.7",
    "autoprefixer": "^10.4.14",
    "postcss": "^8.4.23",
-    "tailwindcss": "^3.3.1"
+    "tailwindcss": "^3.3.1",
+    "vitest": "^0.31.0"
  }
 }
--- a/examples/openspending/pages/@org/[org]/[...path].tsx
+++ b/examples/openspending/pages/@org/[org]/[...path].tsx
@@ -1,126 +0,0 @@
-import { NextSeo } from 'next-seo';
-import { promises as fs } from 'fs';
-import path from 'path';
-import getConfig from 'next/config';
-import { getProject, GithubProject } from '../../../lib/octokit';
-import ReactMarkdown from 'react-markdown';
-import remarkGfm from 'remark-gfm';
-import Breadcrumbs from '../../../components/_shared/Breadcrumbs';
-
-export default function ProjectPage({ project }) {
-  const repoId = `@${project.repo_config.owner}/${project.repo_config.repo}`
-
-  return (
-    <>
-      <NextSeo title={`${repoId}${project.base_path !== '/' ? '/' + project.base_path : ''} - GitHub Datasets`} />
-      <main className="prose mx-auto my-8">
-        <Breadcrumbs links={[{ title: repoId, href: "" }]} />
-        <h1 className="mb-0 mt-16">{project.repo_config.name || repoId}</h1>
-        <p className='mb-8'><span className='font-semibold'>Repository:</span> <a target="_blank" href={project.html_url}>{project.html_url}</a></p>
-
-        <h2 className="mb-0 mt-10">Files</h2>
-        <div className="inline-block min-w-full py-2 align-middle">
-          <table className="min-w-full divide-y divide-gray-300">
-            <thead>
-              <tr>
-                <th
-                  scope="col"
-                  className="px-3 py-3.5 text-left text-sm font-semibold text-gray-900"
-                >
-                  Name
-                </th>
-                <th
-                  scope="col"
-                  className="px-3 py-3.5 text-left text-sm font-semibold text-gray-900"
-                >
-                  Size
-                </th>
-              </tr>
-            </thead>
-            <tbody className="divide-y divide-gray-200">
-              {project.files.map((file) => (
-                <tr key={file.download_url}>
-                  <td className="whitespace-nowrap px-3 py-4 text-sm text-gray-500">
-                    <a href={file.download_url}>{file.name}</a>
-                  </td>
-                  <td className="whitespace-nowrap px-3 py-4 text-sm text-gray-500">
-                    {file.size} Bytes
-                  </td>
-                </tr>
-              ))}
-            </tbody>
-          </table>
-        </div>
-
-        {project.readmeContent && <>
-          <hr />
-
-          <h2 className='uppercase font-black'>Readme</h2>
-          <ReactMarkdown remarkPlugins={[remarkGfm]}>
-            {project.readmeContent}
-          </ReactMarkdown>
-        </>}
-      </main>
-    </>
-  );
-}
-
-// Generates `/posts/1` and `/posts/2`
-export async function getStaticPaths() {
-  const jsonDirectory = path.join(
-    process.cwd(),
-    'datasets.json'
-  );
-  const repos = await fs.readFile(jsonDirectory, 'utf8');
-
-  return {
-    paths: JSON.parse(repos).map((repo) => {
-      const projectPath =
-        repo.readme && repo.readme.split('/').length > 1
-          ? repo.readme.split('/').slice(0, -1)
-          : null;
-      let path = [repo.repo];
-      if (projectPath) {
-        projectPath.forEach((element) => {
-          path.push(element);
-        });
-      }
-      return {
-        params: { org: repo.owner, path },
-      };
-    }),
-    fallback: false, // can also be true or 'blocking'
-  };
-}
-
-export async function getStaticProps({ params }) {
-  const jsonDirectory = path.join(
-    process.cwd(),
-    'datasets.json'
-  );
-  const reposFile = await fs.readFile(jsonDirectory, 'utf8');
-  const repos: GithubProject[] = JSON.parse(reposFile);
-  const repo = repos.find((_repo) => {
-    const projectPath =
-      _repo.readme && _repo.readme.split('/').length > 1
-        ? _repo.readme.split('/').slice(0, -1)
-        : null;
-    let path = [_repo.repo];
-    if (projectPath) {
-      projectPath.forEach((element) => {
-        path.push(element);
-      });
-    }
-    return (
-      _repo.owner == params.org &&
-      JSON.stringify(path) === JSON.stringify(params.path)
-    );
-  });
-  const github_pat = getConfig().serverRuntimeConfig.github_pat;
-  const project = await getProject(repo, github_pat);
-  return {
-    props: {
-      project: { ...project, repo_config: repo },
-    },
-  };
-}
--- a/examples/openspending/pages/@org/[org]/[project].tsx
+++ b/examples/openspending/pages/@org/[org]/[project].tsx
@@ -0,0 +1,275 @@
+import { NextSeo } from 'next-seo';
+import getConfig from 'next/config';
+import {
+  getAllProjectsFromOrg,
+  getProjectDataPackage,
+  getProjectMetadata,
+  getProjectReadme,
+} from '../../../lib/project';
+import ReactMarkdown from 'react-markdown';
+import remarkGfm from 'remark-gfm';
+import { loadDataPackage } from '../../../lib/loader';
+import Layout from '../../../components/_shared/Layout';
+import Link from 'next/link';
+import { Project } from '../../../lib/project.interface';
+import ExternalLinkIcon from '../../../components/icons/ExternalLinkIcon';
+import { FlatUiTable } from '@/components/FlatUiTable';
+
+export default function ProjectPage({
+  project,
+  readme,
+}: {
+  project: Project;
+  readme: string;
+}) {
+  //  Get description from datapackage or  calculate
+  //  excerpt from README by getting all the content
+  //  up to the first dot.
+  const description =
+    project.description || (readme && readme.slice(0, readme.indexOf('.') + 1));
+
+  return (
+    <Layout>
+      <NextSeo title={`${project.title} - OpenSpending`} />
+      <main className="prose mx-auto my-8">
+        <h1 className="mb-1 mt-16">{project.title || project.name}</h1>
+        <Link target="_blank" href={project.repo.url}>
+          @{project.repo.full_name}
+        </Link>
+
+        {description && (
+          <div className="inline-block min-w-full py-2 align-middle mt-5">
+            {description}
+          </div>
+        )}
+
+        <div className="inline-block min-w-full py-2 align-middle">
+          <table className="min-w-full divide-y divide-gray-300">
+            <thead>
+              <tr>
+                <th
+                  scope="col"
+                  className="px-3 py-3.5 text-left text-sm font-semibold text-gray-900"
+                >
+                  Name
+                </th>
+                {project.datapackage.countryCode && (
+                  <th
+                    scope="col"
+                    className="px-3 py-3.5 text-left text-sm font-semibold text-gray-900"
+                  >
+                    Country
+                  </th>
+                )}
+                <th
+                  scope="col"
+                  className="px-3 py-3.5 text-left text-sm font-semibold text-gray-900"
+                >
+                  Metadata
+                </th>
+              </tr>
+            </thead>
+            <tbody className="divide-y divide-gray-200">
+              <tr>
+                <td className="whitespace-nowrap px-3 py-4 text-sm text-gray-500">
+                  {project.name}
+                </td>
+                {project.datapackage.countryCode && (
+                  <td className="whitespace-nowrap px-3 py-4 text-sm text-gray-500">
+                    {project.datapackage.countryCode}
+                  </td>
+                )}
+
+                <td className="whitespace-nowrap px-3 py-4 text-sm text-gray-500">
+                  <Link
+                    // TODO: this link may be incorrect for some datasets
+                    href={`https://github.com/${project.owner.name}/${project.repo.name}/blob/main/datapackage.json`}
+                    target="_blank"
+                    className="flex items-center hover:text-gray-700"
+                  >
+                    datapackage.json <ExternalLinkIcon className="ml-1" />
+                  </Link>
+                </td>
+              </tr>
+            </tbody>
+          </table>
+        </div>
+
+        <h3 className="mb-1 mt-10">Data files</h3>
+        <p>
+          This dataset contains {project.files.length} file
+          {project.files.length == 1 ? '' : 's'}
+        </p>
+        <div className="inline-block min-w-full py-2 align-middle">
+          <table className="mt-0 min-w-full divide-y divide-gray-300">
+            <thead>
+              <tr>
+                <th
+                  scope="col"
+                  className="px-3 py-3.5 text-left text-sm font-semibold text-gray-900"
+                >
+                  Name
+                </th>
+                <th
+                  scope="col"
+                  className="px-3 py-3.5 text-left text-sm font-semibold text-gray-900"
+                >
+                  Format
+                </th>
+                <th
+                  scope="col"
+                  className="px-3 py-3.5 text-left text-sm font-semibold text-gray-900"
+                >
+                  Size
+                </th>
+              </tr>
+            </thead>
+            <tbody className="divide-y divide-gray-200">
+              {project.files?.map((file) => {
+                let size: number | string = file.size;
+
+                if (!size) {
+                  if (file.bytes) {
+                    if (file.bytes > 1000000) {
+                      size = (file.bytes / 1000000).toFixed(2) + ' MB';
+                    } else {
+                      size = (file.bytes / 1000).toFixed(2) + ' kB';
+                    }
+                  }
+                }
+                return (
+                  <tr key={file.name}>
+                    <td className="whitespace-nowrap px-3 py-4 text-sm text-gray-500">
+                      {file.name}
+                    </td>
+                    <td className="whitespace-nowrap px-3 py-4 text-sm text-gray-500">
+                      {file.format}
+                    </td>
+                    <td className="whitespace-nowrap px-3 py-4 text-sm text-gray-500">
+                      {size}
+                    </td>
+
+                    <td className="whitespace-nowrap px-3 py-4 text-sm text-gray-500">
+                      <Link
+                        target="_blank"
+                        href={
+                          file.path.startsWith('http')
+                            ? file.path
+                            : `https://raw.githubusercontent.com/${project.owner.name}/${project.repo.name}/main/${file.path}`
+                        }
+                      >
+                        Download
+                      </Link>
+                    </td>
+                  </tr>
+                );
+              })}
+            </tbody>
+          </table>
+        </div>
+
+        <div className="flex flex-col gap-y-16 ">
+          {project.files?.map((file) => {
+            let size: number | string = file.size;
+
+            if (!size) {
+              if (file.bytes) {
+                if (file.bytes > 1000000) {
+                  size = (file.bytes / 1000000).toFixed(2) + ' MB';
+                } else {
+                  size = (file.bytes / 1000).toFixed(2) + ' kB';
+                }
+              }
+            }
+            return (
+              <div key={file.name}>
+                {file.path && (
+                  <>
+                    <h4>
+                      {file.name}
+                      {file.format ? `.${file.format}` : ''}
+                    </h4>
+                    {file.bytes >= 5132288 && (
+                      <span>Previewing 5MB out of {size}</span>
+                    )}
+                    <FlatUiTable
+                      url={
+                        file.path.startsWith('http')
+                          ? file.path
+                          : `https://raw.githubusercontent.com/${project.owner.name}/${project.repo.name}/main/${file.path}`
+                      }
+                    />
+                  </>
+                )}
+              </div>
+            );
+          })}
+        </div>
+
+        {readme && (
+          <>
+            <hr />
+
+            <h2 className="uppercase font-black">Readme</h2>
+            <ReactMarkdown remarkPlugins={[remarkGfm]}>{readme}</ReactMarkdown>
+          </>
+        )}
+      </main>
+    </Layout>
+  );
+}
+
+// Generates `/posts/1` and `/posts/2`
+export async function getStaticPaths() {
+  const github_pat = getConfig().serverRuntimeConfig.github_pat;
+
+  const allProjects = await getAllProjectsFromOrg(
+    'os-data',
+    'main',
+    github_pat
+  );
+
+  const paths = allProjects.results.map((project) => ({
+    params: {
+      // TODO: dynamize the org
+      org: 'os-data',
+      project: project.repo.name,
+    },
+  }));
+
+  return {
+    paths,
+    fallback: false, // can also be true or 'blocking'
+  };
+}
+
+export async function getStaticProps({ params }) {
+  const { org: orgName, project: projectName } = params;
+
+  const github_pat = getConfig().serverRuntimeConfig.github_pat;
+  const datapackage = await getProjectDataPackage(
+    orgName,
+    projectName,
+    'main',
+    github_pat
+  );
+
+  const repo = await getProjectMetadata(orgName, projectName, github_pat);
+
+  const project = loadDataPackage(datapackage, repo);
+
+  // TODO: should this be moved to the loader?
+  const readme = await getProjectReadme(
+    orgName,
+    projectName,
+    'main',
+    github_pat
+  );
+
+  return {
+    props: {
+      project,
+      readme,
+    },
+  };
+}
--- a/examples/openspending/pages/_app.tsx
+++ b/examples/openspending/pages/_app.tsx
@@ -1,13 +1,11 @@
 import { AppProps } from 'next/app';
-import Head from 'next/head';
 import './styles.css';
+import { NextSeo } from 'next-seo';

 function CustomApp({ Component, pageProps }: AppProps) {
  return (
    <>
-      <Head>
-        <title>GitHub Datasets</title>
-      </Head>
+      <NextSeo title="OpenSpending" />
      <main className="app">
        <Component {...pageProps} />
      </main>
--- a/examples/openspending/pages/index.tsx
+++ b/examples/openspending/pages/index.tsx
@@ -1,44 +1,59 @@
-import { promises as fs } from 'fs';
-import path from 'path';
-import { getProject } from '../lib/octokit';
+import { getAllProjectsFromOrg } from '../lib/project';
 import getConfig from 'next/config';
-import ExternalLinkIcon from '../components/icons/ExternalLinkIcon';
-import TimeAgo from 'react-timeago';
-import Link from 'next/link';
 import { Hero } from '../components/Hero';
-import { Header } from '../components/Header';
 import { Container } from '../components/Container';
+import { FiscalDataPackage } from '../lib/datapackage.interface';
+import { loadDataPackage } from '../lib/loader';
+import DatasetsSearch from '../components/DatasetsSearch';
+import Layout from '../components/_shared/Layout';

 export async function getStaticProps() {
-  const jsonDirectory = path.join(
-    process.cwd(),
-    '/datasets.json'
-  );
-  const repos = await fs.readFile(jsonDirectory, 'utf8');
+  //  TODO: support other orgs
+  // const orgsListPath = path.join(process.cwd(), '/orgs.json');
+  // const orgs = await fs.readFile(orgsListPath, 'utf8');
+
  const github_pat = getConfig().serverRuntimeConfig.github_pat;

-  const projects = await Promise.all(
-    (JSON.parse(repos)).map(async (repo) => {
-      const project = await getProject(repo, github_pat);
-      return { ...project, repo_config: repo };
-    })
+  const allProjects = await getAllProjectsFromOrg(
+    'os-data',
+    'main',
+    github_pat
  );

+  const projects = allProjects.results.map(
+    (item: { datapackage: FiscalDataPackage & { repo: string }; repo: any }) =>
+      loadDataPackage(item.datapackage, item.repo)
+  );
+
+  const availableCountries = projects
+    .map((item) => item.countryCode)
+    .filter((v) => v) //  Filters false values
+    .filter((v, i, a) => a.indexOf(v) === i) //  Remove duplicates
+    //  TODO: title should be the full name
+    .map((code) => ({ code, title: code }));
+
  return {
    props: {
-      projects,
+      projects: JSON.stringify(projects),
+      availableCountries,
    },
  };
 }

-export function Datasets({ projects }) {
+export function Home({ projects, availableCountries }) {
+  projects = JSON.parse(projects);
+
  return (
-    <div className="bg-white min-h-screen">
-      <Header />
-      <Hero />
-      <section
-        className="py-20 sm:py-32"
-      >
+    <Layout>
+      <Hero
+        countriesCount={availableCountries.length}
+        datasetsCount={projects.length}
+        filesCount={projects.reduce(
+          (partialSum, a) => partialSum + a.files.length,
+          0
+        )}
+      />
+      <section className="py-20 sm:py-32">
        <Container>
          <div className="mx-auto max-w-2xl lg:mx-0">
            <h2
@@ -51,80 +66,16 @@ export function Datasets({ projects }) {
              Find spending data about countries all around the world.
            </p>
          </div>
-          <div className="mt-5">
-            <div className="-mx-4 -my-2 overflow-x-auto sm:-mx-6 lg:-mx-8">
-              <div className="inline-block min-w-full py-2 align-middle sm:px-6 lg:px-8">
-                <table className="min-w-full divide-y divide-gray-300">
-                  <thead>
-                    <tr>
-                      <th
-                        scope="col"
-                        className="px-3 py-3.5 text-left text-sm font-semibold text-gray-900"
-                      >
-                        Name
-                      </th>
-                      <th
-                        scope="col"
-                        className="px-3 py-3.5 text-left text-sm font-semibold text-gray-900"
-                      >
-                        Repository
-                      </th>
-                      <th
-                        scope="col"
-                        className="px-3 py-3.5 text-left text-sm font-semibold text-gray-900"
-                      >
-                        Description
-                      </th>
-                      <th
-                        scope="col"
-                        className="px-3 py-3.5 text-left text-sm font-semibold text-gray-900"
-                      >
-                        Last updated
-                      </th>
-                      <th
-                        scope="col"
-                        className="relative py-3.5 pl-3 pr-4 sm:pr-0"
-                      ></th>
-                    </tr>
-                  </thead>
-                  <tbody className="divide-y divide-gray-200">
-                    {projects.map((project) => (
-                      <tr key={project.id}>
-                        <td className="whitespace-nowrap px-3 py-6 text-sm text-gray-500">
-                          {project.repo_config.name
-                            ? project.repo_config.name
-                            : project.full_name + (project.base_path === '/' ? '' : '/' + project.base_path)}
-                        </td>
-                        <td className="whitespace-nowrap px-3 py-6 text-sm group text-gray-500 hover:text-gray-900 transition-all duration-250">
-                          <a href={project.html_url} target="_blank" className='flex items-center'>@{project.full_name} <ExternalLinkIcon className='ml-1' /></a>
-                        </td>
-                        <td className="px-3 py-4 text-sm text-gray-500">
-                          {project.repo_config.description
-                            ? project.repo_config.description
-                            : project.description}
-                        </td>
-                        <td className="whitespace-nowrap px-3 py-6 text-sm text-gray-500">
-                          <TimeAgo date={new Date(project.last_updated)} />
-                        </td>
-                        <td className="relative whitespace-nowrap py-6 pl-3 pr-4 text-right text-sm font-medium sm:pr-0">
-                          <a
-                            href={`/@${project.repo_config.owner}/${project.repo_config.repo}/${project.base_path === '/' ? '' : project.base_path}`}
-                            className='border border-gray-900 text-gray-900 px-4 py-2 transition-all hover:bg-gray-900 hover:text-white'
-                          >
-                            info
-                          </a>
-                        </td>
-                      </tr>
-                    ))}
-                  </tbody>
-                </table>
-              </div>
-            </div>
+          <div className="mt-10">
+            <DatasetsSearch
+              datasets={projects}
+              availableCountries={availableCountries}
+            />
          </div>
        </Container>
      </section>
-    </div>
+    </Layout>
  );
 }

-export default Datasets;
+export default Home;
--- a/examples/openspending/public/assets/org-icon.svg
+++ b/examples/openspending/public/assets/org-icon.svg
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Uploaded to: SVG Repo, www.svgrepo.com, Generator: SVG Repo Mixer Tools -->
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg fill="#000000" version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="800px" height="800px" viewBox="0 0 120 120" enable-background="new 0 0 120 120" xml:space="preserve">
+<rect x="2" y="108.1" width="116" height="11.9"/>
+<rect x="6.744" y="96.582" width="104.979" height="6.543"/>
+<rect x="15.288" y="38.532" width="17.639" height="52.925"/>
+<rect x="50.484" y="38.532" width="17.639" height="52.925"/>
+<rect x="84.33" y="38.532" width="17.639" height="52.925"/>
+<polygon points="0,26.96 60,0 120,26.96 119.946,33.912 0,34.01 "/>
+</svg>
--- a/examples/openspending/tsconfig.json
+++ b/examples/openspending/tsconfig.json
@@ -13,7 +13,10 @@
    "resolveJsonModule": true,
    "isolatedModules": true,
    "jsx": "preserve",
-    "incremental": true
+    "incremental": true,
+    "paths": {
+      "@/*": ["./*"]
+    }
  },
  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx"],
  "exclude": ["node_modules"]
--- a/examples/openspending/vitest.config.ts
+++ b/examples/openspending/vitest.config.ts
@@ -0,0 +1,10 @@
+import { defineConfig } from 'vitest/config'
+import react from '@vitejs/plugin-react'
+
+// https://vitejs.dev/config/
+export default defineConfig({
+  plugins: [react()],
+  test: {
+    environment: 'jsdom',
+  },
+})
--- a/examples/alan-turing-portal/.eslintrc.json
+++ b/examples/alan-turing-portal/.eslintrc.json
--- a/examples/alan-turing-portal/.gitignore
+++ b/examples/alan-turing-portal/.gitignore
--- a/examples/alan-turing-portal/LICENSE.md
+++ b/examples/alan-turing-portal/LICENSE.md
--- a/examples/alan-turing-portal/README.md
+++ b/examples/alan-turing-portal/README.md
--- a/examples/alan-turing-portal/components/Card.jsx
+++ b/examples/alan-turing-portal/components/Card.jsx
--- a/examples/alan-turing-portal/components/Container.jsx
+++ b/examples/alan-turing-portal/components/Container.jsx
--- a/examples/alan-turing-portal/components/Footer.jsx
+++ b/examples/alan-turing-portal/components/Footer.jsx
--- a/examples/alan-turing-portal/components/Header.jsx
+++ b/examples/alan-turing-portal/components/Header.jsx
@@ -140,7 +140,7 @@ function MobileNavigation(props) {
            </div>
            <nav className="mt-6">
              <ul className="-my-2 divide-y divide-zinc-100 text-base text-zinc-800 dark:divide-zinc-100/5 dark:text-zinc-300">
-                <MobileNavItem href="https://github.com/leondz/hatespeechdata">
+                <MobileNavItem href="https://github.com/datopian/portaljs/tree/main/examples/turing">
                  View on Github <GithubIcon />
                </MobileNavItem>
              </ul>
@@ -179,7 +179,7 @@ function DesktopNavigation(props) {
  return (
    <nav {...props}>
      <ul className="flex rounded-full bg-white/90 px-3 text-sm font-medium text-zinc-800 shadow-lg shadow-zinc-800/5 ring-1 ring-zinc-900/5 backdrop-blur dark:bg-zinc-800/90 dark:text-zinc-200 dark:ring-white/10">
-        <NavItem href="https://github.com/leondz/hatespeechdata">
+        <NavItem href="https://github.com/datopian/portaljs/tree/main/examples/turing">
          View on Github <GithubIcon />
        </NavItem>
      </ul>
--- a/examples/alan-turing-portal/content/about.md
+++ b/examples/alan-turing-portal/content/about.md
--- a/examples/alan-turing-portal/content/datasets/abusive-eval-v1-0.md
+++ b/examples/alan-turing-portal/content/datasets/abusive-eval-v1-0.md
--- a/examples/alan-turing-portal/content/datasets/abusive-language-detection-on-arabic-social-media-al-jazeera.md
+++ b/examples/alan-turing-portal/content/datasets/abusive-language-detection-on-arabic-social-media-al-jazeera.md
--- a/examples/alan-turing-portal/content/datasets/coral-a-context-aware-croatian-abusive-language-dataset.md
+++ b/examples/alan-turing-portal/content/datasets/coral-a-context-aware-croatian-abusive-language-dataset.md
--- a/examples/alan-turing-portal/content/datasets/detecting-abusive-albanian.md
+++ b/examples/alan-turing-portal/content/datasets/detecting-abusive-albanian.md
--- a/examples/alan-turing-portal/content/datasets/hate-speech-detection-in-the-bengali-language-a-dataset-and-its-baseline-evaluation.md
+++ b/examples/alan-turing-portal/content/datasets/hate-speech-detection-in-the-bengali-language-a-dataset-and-its-baseline-evaluation.md
--- a/examples/alan-turing-portal/content/datasets/large-scale-hate-speech-detection-with-cross-domain-tranfer.md
+++ b/examples/alan-turing-portal/content/datasets/large-scale-hate-speech-detection-with-cross-domain-tranfer.md
--- a/examples/alan-turing-portal/content/datasets/let-mi-an-arabic-levantine-twitter-dataset-for-mysogynistic-language.md
+++ b/examples/alan-turing-portal/content/datasets/let-mi-an-arabic-levantine-twitter-dataset-for-mysogynistic-language.md
--- a/examples/alan-turing-portal/content/datasets/measuring-hate-speech.md
+++ b/examples/alan-turing-portal/content/datasets/measuring-hate-speech.md
--- a/examples/alan-turing-portal/content/datasets/offensive-language-and-hate-speech-detection-for-danish.md
+++ b/examples/alan-turing-portal/content/datasets/offensive-language-and-hate-speech-detection-for-danish.md
--- a/examples/alan-turing-portal/content/index.mdx
+++ b/examples/alan-turing-portal/content/index.mdx
@@ -36,7 +36,7 @@ In the following page type `content/datasets/<name-of-the-file>.md`. if you want

 ### Fill in content

-Copy the contents of `templates/dataset.md` or `templates/keywords.md` respectively to the camp below, filling out the fields with the correct data format
+Copy the contents of `templates/dataset.md` or `templates/keywords.md` respectively to the camp below, filling out the fields with the correct data format. Everything below the second `---` will automatically get rendered into the page, so you may add any standard markdown fields e.g tables, headings, lists...

 ![](https://i.imgur.com/x6JIjhz.png)

--- a/examples/alan-turing-portal/content/keywords/hurtlex.md
+++ b/examples/alan-turing-portal/content/keywords/hurtlex.md
--- a/examples/alan-turing-portal/content/keywords/jiang-et-al.md
+++ b/examples/alan-turing-portal/content/keywords/jiang-et-al.md
--- a/examples/alan-turing-portal/jsconfig.json
+++ b/examples/alan-turing-portal/jsconfig.json
--- a/examples/alan-turing-portal/lib/formatDate.js
+++ b/examples/alan-turing-portal/lib/formatDate.js
--- a/examples/alan-turing-portal/lib/markdown.js
+++ b/examples/alan-turing-portal/lib/markdown.js
--- a/examples/alan-turing-portal/lib/mddb.ts
+++ b/examples/alan-turing-portal/lib/mddb.ts
--- a/examples/alan-turing-portal/next-env.d.ts
+++ b/examples/alan-turing-portal/next-env.d.ts
--- a/examples/alan-turing-portal/next.config.js
+++ b/examples/alan-turing-portal/next.config.js
--- a/examples/alan-turing-portal/package-lock.json
+++ b/examples/alan-turing-portal/package-lock.json
--- a/examples/alan-turing-portal/package.json
+++ b/examples/alan-turing-portal/package.json
--- a/examples/alan-turing-portal/pages/[...slug].jsx
+++ b/examples/alan-turing-portal/pages/[...slug].jsx
@@ -6,7 +6,6 @@ import { Card } from '../components/Card'
 import Head from 'next/head'
 import parse from '../lib/markdown'
 import { Mermaid } from '@flowershow/core';
-import { Header } from '../components/Header';

 export const getStaticProps = async ({ params }) => {
  const urlPath = params.slug ? params.slug.join('/') : ''
@@ -82,15 +81,13 @@ export default function DRDPage({ mdxSource }) {
  )
  return (
    <>
-      <Header />
      <Head>
        <title>{meta.title}</title>
      </Head>
-      <Container className="mt-16 lg:mt-32 relative">
-        <Header />
+      <Container className="mt-9 relative">
        <article>
          <header className="flex flex-col">
-            <h1 className="mt-6 text-4xl font-bold tracking-tight text-zinc-800 dark:text-zinc-100 sm:text-5xl">
+            <h1 className="text-4xl font-bold tracking-tight text-zinc-800 dark:text-zinc-100 sm:text-5xl">
              {meta.title}
            </h1>
            <Card as="article">
--- a/examples/alan-turing-portal/pages/_app.jsx
+++ b/examples/alan-turing-portal/pages/_app.jsx
--- a/examples/alan-turing-portal/pages/_document.jsx
+++ b/examples/alan-turing-portal/pages/_document.jsx
--- a/examples/alan-turing-portal/pages/index.jsx
+++ b/examples/alan-turing-portal/pages/index.jsx
--- a/examples/alan-turing-portal/postcss.config.js
+++ b/examples/alan-turing-portal/postcss.config.js
--- a/examples/alan-turing-portal/prettier.config.js
+++ b/examples/alan-turing-portal/prettier.config.js
--- a/examples/alan-turing-portal/public/favicon.ico
+++ b/examples/alan-turing-portal/public/favicon.ico
--- a/examples/alan-turing-portal/styles/prism.css
+++ b/examples/alan-turing-portal/styles/prism.css
--- a/examples/alan-turing-portal/styles/tailwind.css
+++ b/examples/alan-turing-portal/styles/tailwind.css
--- a/examples/alan-turing-portal/tailwind.config.js
+++ b/examples/alan-turing-portal/tailwind.config.js
--- a/examples/alan-turing-portal/templates/dataset.md
+++ b/examples/alan-turing-portal/templates/dataset.md
--- a/examples/alan-turing-portal/templates/list-of-keywords.md
+++ b/examples/alan-turing-portal/templates/list-of-keywords.md
--- a/examples/alan-turing-portal/tsconfig.json
+++ b/examples/alan-turing-portal/tsconfig.json
--- a/site/components/Layout.tsx
+++ b/site/components/Layout.tsx
@@ -161,13 +161,14 @@ export default function Layout({
        >
          Built by{' '}
          <img
-            src={
-              theme === 'dark'
-                ? '/images/datopian-light-logotype.svg'
-                : '/images/datopian-dark-logotype.svg'
-            }
+            src="/images/datopian-light-logotype.svg"
            alt="Datopian Logo"
-            className="h-6 ml-2"
+            className="h-6 ml-2 hidden dark:block"
+          />
+          <img
+            src="/images/datopian-dark-logotype.svg"
+            alt="Datopian Logo"
+            className="h-6 ml-2 dark:hidden"
          />
        </a>
      </footer>
--- a/site/content/assets/howto/catalog-example.png
+++ b/site/content/assets/howto/catalog-example.png
--- a/site/content/assets/howto/catalog-facets-example.png
+++ b/site/content/assets/howto/catalog-facets-example.png
--- a/site/content/assets/howto/comments-example.png
+++ b/site/content/assets/howto/comments-example.png
--- a/site/content/assets/howto/linechart-example.png
+++ b/site/content/assets/howto/linechart-example.png
--- a/site/content/assets/howto/table-example.png
+++ b/site/content/assets/howto/table-example.png
--- a/site/content/config.js
+++ b/site/content/config.js
@@ -21,6 +21,7 @@ const config = {
    { name: "Blog", href: "/blog" },
    { name: "Showcases", href: "/#showcases" },
    { name: "Examples", href: "https://github.com/datopian/portaljs/tree/main/examples", target: "_blank" },
+    { name: "Components", href: "https://storybook.portaljs.org", target: "_blank" },
    // { name: "DL Demo", href: "/data-literate/demo" },
    // { name: "Excel Viewer", href: "/excel-viewer" },
  ],
--- a/site/content/howto/analytics.md
+++ b/site/content/howto/analytics.md
@@ -0,0 +1,77 @@
+# How to add Google Analytics?
+
+>[!todo] Prerequisites
+>- [Google Analytics account](https://support.google.com/analytics/answer/9304153?hl=en)
+>- [Google tag ID](https://support.google.com/analytics/answer/12270356?hl=en#:~:text=A%20Measurement%20ID%20is%20an,same%20as%20your%20destination%20ID.)
+
+The following piece of code adds pageview tracking functionality to the custom Next.js App in `/pages/_app.tsx`, but you can use it only in specific pages if you want.
+
+```tsx
+// /pages/_app.tsx
+import { useRouter } from "next/router";
+import { useEffect } from "react";
+import Script from "next/script";
+
+// Step 0:
+// Add your Google tag ID to your local .env.local file, e.g. under GA_TRACKING_ID
+
+// Step 1: create the following pageview function
+const pageview = ({
+    url,
+    analyticsID,
+}: {
+    url: string;
+    analyticsID: string;
+}) => {
+    if (typeof window.gtag !== undefined) {
+        window.gtag("config", analyticsID, {
+            page_path: url,
+        });
+    }
+};
+
+export default function MyApp({ Component, pageProps }) {
+	const router = useRouter();
+
+    // ... your code
+
+    // Step 3: Add the following useEffect to trigger pageview on each route change
+    useEffect(() => {
+        const handleRouteChange = (url) => {
+            pageview(url, GA_TRACKING_ID);
+        };
+        router.events.on("routeChangeComplete", handleRouteChange);
+        return () => {
+            router.events.off("routeChangeComplete", handleRouteChange);
+        };
+    }, [router.events]);
+
+    return (
+		{/* Step 4: Install Google Analytics tag */}
+        <>
+            <Script
+                strategy="afterInteractive"
+                src={`https://www.googletagmanager.com/gtag/js?id=${GA_TRACKING_ID}`}
+            />
+            <Script
+                id="gtag-init"
+                strategy="afterInteractive"
+                dangerouslySetInnerHTML={{
+                    __html: `
+              window.dataLayer = window.dataLayer || [];
+              function gtag(){dataLayer.push(arguments);}
+              gtag('js', new Date());
+              gtag('config', '${GA_TRACKING_ID}', {
+                page_path: window.location.pathname,
+              });
+            `,
+                }}
+            />
+            <Component {...pageProps} />
+        </>
+    );
+};
+```
+
+>[!info]
+> For more info on measuring pageviews with Google Analytics see [Google Analytics documentation](https://developers.google.com/analytics/devguides/collection/gtagjs/pages).
--- a/site/content/howto/blog.md
+++ b/site/content/howto/blog.md
@@ -0,0 +1,75 @@
+# How to add a simple blog?
+
+## Setup
+
+The following example uses components imported from the [`@flowershow/core` package](https://github.com/datopian/flowershow). If you want to follow along install it too:
+
+```sh
+npm i @flowershow/core
+```
+
+## Create home page for your blogs
+
+Add the following code to the Next.js page that is going to be your blog home page, e.g. to `/pages/blog/index.tsx`:
+
+```tsx
+import { BlogsList, SimpleLayout } from "@flowershow/core";
+
+// pass a list of blogs, home page title and home page description, e.g. from `getStaticProps`
+export default function BlogIndex({ blogs, title, description }) {
+    return (
+        <SimpleLayout title={title} description={description}>
+            <BlogsList blogs={blogs} />
+        </SimpleLayout>
+    );
+}
+```
+
+`BlogsList` component has the following API:
+
+```ts
+interface BlogsListProps {
+	blogs: Blog;
+}
+
+interface Blog {
+	title: string;
+	date: string;
+	urlPath: string;
+	description?: string;
+	authors?: Array<string>;
+	tags?: Array<string>;	
+}
+```
+
+## Create blog post pages
+
+Add the following code to your blog pages, e.g. to `/pages/blog/[...slug].tsx`:
+
+```tsx
+import { BlogLayout } from "@flowershow/core";
+
+export default BlogPost({ content, title, date, authors }) {
+	return (
+		<BlogLayout title={title} date={date} authors={authors}
+			{content}
+		</BlogLayout>
+	)	
+}
+```
+
+`BlogLayout` component has the following API:
+
+```ts
+interface BlogLayoutProps {
+	title?: string;
+	date?: string;
+	authors?: Array<Author>;
+}
+
+interface Author {
+	name: string;
+	avatar: string; // avatar image path
+	urlPath?: string; // author page
+}
+```
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
deme	c893911e67	[examples/openspending][xl]: add table preview to showcase page, minor fixes	2023-05-19 14:43:06 -03:00
Luccas Mateus de Medeiros Gomes	ee6efc7431	[site][xs] - add components tab in navbar	2023-05-19 07:04:16 -03:00
Ola Rubaj	a62addbfbb	Dev how-to pages (#890 ) Related to #878 ## Changes How-to docs pages: - /howto/index: home page for guides - /howto/analytics: "How to add Google Analytics?" - /howto/seo: "How to customize page metadata for SEO?" - /howto/sitemap: "How to build a sitemap?" - /howto/blog: "How to add a simple blog?" - blog index page - blog layout - comments -> link to the page below - /howto/comments: "How to add user comments?" - /howto/markdown: "How to add markdown-based content pages?" - /howto/drd: "How to create data-rich documents with charts and tables?"	2023-05-19 11:15:52 +02:00
João Demenech	adb6d1bb0e	Implement dataset page v0.1 + Home improvements (#892 ) * [examples/openspending][xl]: implement dataset page v0.1, add pagination to the datasets grid * [examples/openspending][m] - fix build + add tests --------- Co-authored-by: Luccas Mateus de Medeiros Gomes <luccasmmg@gmail.com>	2023-05-18 21:19:01 -03:00
Luccas Mateus	2115a3fdb3	[examples/openspending][m] - table preview (#891 ) * [examples/openspending][m] - table preview * [examples/openspending][xs] - fix typo	2023-05-18 15:09:57 -03:00
João Demenech	efd8c85926	Load datasets + Datasets grid + Datasets search (#889 ) * [examples/openspending][m] - added loader + fetching from datapackage - Also added an indexing example * [examples/openspending,home][xl]: removes datasets table, implement dataset cards grid, implement country facet * [examples/openspending,home][m]: add min date and max date facets --------- Co-authored-by: Luccas Mateus de Medeiros Gomes <luccasmmg@gmail.com>	2023-05-18 07:21:30 -03:00
Luccas Mateus	4e91e88f2b	[examples/github-backed-catalog] - improvements after issue #871 (#887 )	2023-05-17 11:10:18 -03:00
Luccas Mateus	ebcb93c996	[examples/turing][xs] - point out that markdown gets rendered	2023-05-16 07:22:45 -03:00
Luccas Mateus	1fc2499c71	[examples/538][xs] - change banner position + text + change README (#877 ) * [examples/538][xs] - change banner position + text + change README * [examples/538] - change banner background * [examples/538][m] - changes after ola comments * [example/538] - fix typo	2023-05-15 12:37:19 -03:00
Luccas Mateus	1af24ef57e	538 banner (#873 ) * [example/538] - banner * [example/538] - title on head	2023-05-12 14:50:31 -03:00
Luccas Mateus de Medeiros Gomes	698c06efda	[site][xs] - fix logo on dark mode	2023-05-12 14:25:02 -03:00
Luccas Mateus de Medeiros Gomes	8792f295b0	[examples/turing][xs] - fix header	2023-05-12 08:26:02 -03:00
Luccas Mateus de Medeiros Gomes	3e6d01c4c7	[examples/538][xs] - go back to v01(only index page)	2023-05-11 19:17:41 -03:00
Luccas Mateus de Medeiros Gomes	7c943c1b31	[example/turing][sm] - forgot to add github on desktop	2023-05-11 17:16:56 -03:00
Luccas Mateus de Medeiros Gomes	7197a6686e	[examples/turing][sm] - change view on github	2023-05-11 17:11:20 -03:00
Luccas Mateus de Medeiros Gomes	7822440f0d	[examples/turing] - rename it to turing	2023-05-11 16:13:09 -03:00
Luccas Mateus de Medeiros Gomes	82773b5e8a	[examples/538] - fix build	2023-05-11 13:28:33 -03:00
Luccas Mateus	1cfc4db528	[examples/538][m] - little fixes and renaming (#870 )	2023-05-11 13:15:18 -03:00