Task: Explore Using Nextra for Docs Site with Search + Auth

[nelsonic]

We need to build a Documentation Website that has:

1. Fast page load times - e.g. via server-side rendering or static pages.
2. Authentication - so we can protect certain pages.
3. Full-text Search - so people can find what they are looking for when there are many pages.

We are going to use the nextra https://nextra.site framework for building this site.

Todo

• Create a new project/repo: https://github.com/dwyl/nextra-demo (will be public soon ...)
• Create a brand new nextra project in it.
• Document all the steps you take for creating the project; no step is too small.
• Add authentication: OAuth2 via: https://nextjs.org/docs/app/building-your-application/authentication
  (if you get stuck, comment on this issue for help!)
• Add some basic content to the site 3-5 pages is enough. Can be about any topic you like; Kittens, Boats, Chocolate, BTC, doesn't matter.
• Protect 2 of the pages using auth i.e. should 404 if the person is not authenticated but display if they are.
  • Document how this is done.
• Enable search.
  • Search should only surface the public pages if the person is not authenticated.
  • Should show the private pages if the person has logged in.
• Tests! 🧪 we need decent (preferably 100%) test coverage on this demo. 💯
• Analytics 📈 📊 Deploy Plausible Analytics to a VPS 📈 📊 🚀 + Document it! 📝  learn-analytics#3

[nelsonic]

Open Question on Plausible Analytics in Nextra: shuding/nextra#3047