The official project website for Datasette.

https://datasette.io/

The site is itself a customized installation of Datasette, using custom templates and plugins to implement the site's functionality.

Take a look at .github/workflows/deploy.yml to see how the site is built and deployed to Google Cloud Run using GitHub Actions.

More background:

• datasette.io, an official project website for Datasette
• Building a search engine for datasette.io
• The Baked Data architectural pattern

Check out this repository, create a virtual environment and run pip install -r requirements.txt for the dependencies.

If you don't want to build the database files from scratch, run this to download them:

./refresh-from-production.sh

To build the database files used by the site you will first need to set an environment variable containing a GitHub personal access token. You can create a token at https://github.com/settings/tokens - then set it as the GITHUB_TOKEN environment variable like so:

export GITHUB_TOKEN="token-here"

Now you can build the databases like this:

scripts/build.sh

Then to run the tests (which check that certain pages do not return errors):

scripts/test.sh

To see the site in your browser:

datasette .

This will run a server at http:https://localhost:8001/