OpenSats.org

This is the codebase behind OpenSats.org.

Getting started

The website is a simple Next.js project bootstrapped with create-next-app. To run it locally you'll need Node.js 14.6.0 or newer. After cloning repository try following 3 commands in terminal:

• npm run dev for running a development instance with hot-reloading, file watching and task re-running
• npm run build for compiling the project.
• npm start for starting your app in production mode

If you start the website (either in development or production mode), you can access it on http://localhost:3000

Codebase organization

• docs/projects hosts Markdown files for all the projects listed on the OpenSats website
• utils folder contains utility functions; md.ts is used for rending markdown content into pages using /pages/projects/[slug].tsx
  • [slug].tsx works by leveraging getStaticPaths and getStaticProps functions
• the rest of the folders are standard for Next.js
  • pages contains files that correspond to individual pages on the website
  • components has common UI components used across the project
• all calls that work with secrets (talking to BTCPay and Stripe) are isolated in server side APIs
  • take a look at pages/api/btcpay.ts as an example

Contributing to the project

PRs are welcome! Fork the repository on your GitHub account, push changes to new feature branch and then open a new pull request on github.com/OpenSats/website/pulls.

Thanks for supporting OpenSats!