This code uses Markdoc as a backbone to render the One Fact Foundation website, alongside the rest of our web properties.
Are you an educator or need to run a Data Thinking workshop? Deploy to Vercel to build your own website using our code!
(created using this link)
Email us at hello@onefact.org if you have any issues using this for your course.
GitHub Pages does not support some features of Next.js
as this library is maintained and aligned with Vercel whose business model depends on differentiating features from GitHub Pages.
One example is incremental static regeneration, which is critical to some of our web properties at the One Fact Foundation.
You can use this GitHub Action to deploy the website using only GitHub technology: https://github.com/onefact/onefact.org/blob/main/.github/workflows/nextjs.yml
If you cannot afford Vercel and need any help deploying to GitHub Pages please email us at hello@onefact.org and we will do our best to help :)
Contributions and feedback are welcomed and encouraged. Feel free to open PRs or issues here to fix typos or suggest changes, or reach our team at [hello@onefact.org](mailto:hello@onefact.org].
-
Install the dependencies by running
npm install
-
Start the development server on http://localhost:3000 by running
npm run dev
-
Try editing
pages/index.md
Test locally using npm run dev
.
Use act to test GitHub Actions deployment locally.
Fork this repo, go to settings > pages > source. In the dropdown, select Github Actions.