https://github.com/simonw/datasette.io

The official project website for Datasette
https://github.com/simonw/datasette.io

datasette

Last synced: 10 days ago
JSON representation

The official project website for Datasette

• Host: GitHub
• URL: https://github.com/simonw/datasette.io
• Owner: simonw
• Created: 2020-06-22T18:29:44.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2024-04-27T06:02:33.000Z (7 months ago)
• Last Synced: 2024-05-01T23:17:28.606Z (6 months ago)
• Topics: datasette
• Language: HTML
• Homepage: https://datasette.io
• Size: 2.31 MB
• Stars: 81
• Watchers: 7
• Forks: 18
• Open Issues: 28
• Metadata Files:
  • Readme: README.md
  • Changelog: news.yaml

Awesome Lists containing this project

README

        
# datasette.io

The official project website for [Datasette](https://github.com/simonw/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](https://github.com/simonw/datasette.io/blob/main/.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](https://simonwillison.net/2020/Dec/13/datasette-io/)

- [Building a search engine for datasette.io](https://simonwillison.net/2020/Dec/19/dogsheep-beta/)

- [The Baked Data architectural pattern](https://simonwillison.net/2021/Jul/28/baked-data/)

## Development

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://localhost:8001/`