{"id":40773109,"url":"https://github.com/performant-software/itsb","last_synced_at":"2026-01-21T18:56:24.327Z","repository":{"id":61157208,"uuid":"530348479","full_name":"performant-software/itsb","owner":"performant-software","description":"In The Same Boats","archived":false,"fork":false,"pushed_at":"2023-05-15T18:08:25.000Z","size":3356,"stargazers_count":1,"open_issues_count":0,"forks_count":2,"subscribers_count":7,"default_branch":"main","last_synced_at":"2024-04-14T12:53:39.830Z","etag":null,"topics":["caribbean","data-visualization","digital-humanities","history","literature","spatial"],"latest_commit_sha":null,"homepage":"https://sameboats.org/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/performant-software.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2022-08-29T18:40:32.000Z","updated_at":"2024-02-01T16:11:59.000Z","dependencies_parsed_at":"2023-02-08T20:15:59.298Z","dependency_job_id":"51dbb33f-3b9f-4b36-b3e1-92cbbc0f4df8","html_url":"https://github.com/performant-software/itsb","commit_stats":{"total_commits":176,"total_committers":6,"mean_commits":"29.333333333333332","dds":0.5056818181818181,"last_synced_commit":"08235aba7250ca90f1faa3888f8fc0a13cb55ec9"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/performant-software/itsb","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/performant-software%2Fitsb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/performant-software%2Fitsb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/performant-software%2Fitsb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/performant-software%2Fitsb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/performant-software","download_url":"https://codeload.github.com/performant-software/itsb/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/performant-software%2Fitsb/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28639900,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-21T18:04:35.752Z","status":"ssl_error","status_checked_at":"2026-01-21T18:03:55.054Z","response_time":86,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["caribbean","data-visualization","digital-humanities","history","literature","spatial"],"created_at":"2026-01-21T18:56:22.835Z","updated_at":"2026-01-21T18:56:24.316Z","avatar_url":"https://github.com/performant-software.png","language":"JavaScript","readme":"# In The Same Boats\n\nA React rewrite of the [_In The Same Boats_](https://github.com/elotroalex/itsb/tree/main) (ITSB) project, which maps the movements of significant cultural actors from the Caribbean and wider Americas, Africa, and Europe within the 20th century Afro-Atlantic world.\n\nThis version of _In The Same Boats_ is built on the [Linked Places](https://github.com/LinkedPasts/linked-places-format) and [Linked Traces](https://github.com/LinkedPasts/linked-traces-format) standards for representing historical and geographical data, and makes use of the [Peripleo](https://github.com/peripleo/peripleo) and [Deck.GL](https://github.com/visgl/deck.gl) libraries for search and interactive visualization.\n\nFor more information and credits, visit the current deployment of [_In The Same Boats_](https://performant-software.github.io/itsb/).\n\n## Usage\n\n### Requirements\n\n- Python v3.9+\n- Node.JS v16\n- NPM v8\n\n### Data generation\n\nThis project takes CSV files in the format created by contributors to the original ITSB project, and converts them to Linked Places and Linked Traces JSON-formatted records.\n\nEach CSV file representing an author's movements should be placed in `/script/in/movements`, while any additional places should be appended to `/script/in/places/ITSB Place Names - Places.csv`.\n\nThen, the following script can be run to convert the CSV formatted data into JSON:\n\n```sh\ncd script\npython ./convertJSON.py\n```\n\nThis will save updated data JSON files to `/public/data`, from where they are served statically and used in the React application. This script will also print warnings and errors about missing or malformed data.\n\n### Installation\n\nTo install NPM dependencies, run the following script from the project root:\n\n```sh\nnpm install\n```\n\n### Build for production\n\nThis project uses [Vite](https://vitejs.dev/) to build a static bundle that can be deployed to a server. To generate a static build output to `/dist`:\n\n```sh\nnpm run build\n```\n\nYou can also preview the built bundle using:\n\n```sh\nnpm run preview\n```\n\nIn this mode, Vite will launch a development server which serves the built assets from the `/dist` folder.\n\n### Deploy\n\nA build of _In The Same Boats_ created using the above steps can be deployed with minimal configuration; for an example build, see the `gh-pages` branch of this repo and its resulting deployment [here](https://performant-software.github.io/itsb/).\n\nWe have configured a GitHub Workflow, stored at `/.github/workflows/gh-pages.yml`, to automatically build and deploy ITSB to this repo's GitHub Pages instance upon any push to the `main` branch.\n\n## Development\n\n### Run in development\n\nThis project uses [Vite](https://vitejs.dev/) to enable hot-module reloading during development. To start a development build served over `localhost:5173`, run the following from the project root:\n\n```sh\nnpm start\n```\n\nThis build will refresh automatically as you save local changes to code in the `/src` directory.\n\n### Unit tests\n\nUnit tests are written using [Vitest](https://vitest.dev/) and stored alongside components in `*.test.js` files, and the entire test suite can be run with the following script from the root directory:\n\n```\nnpm test\n```\n\nA GitHub Workflow is also configured to run unit tests on each push to any branch in this repo.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fperformant-software%2Fitsb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fperformant-software%2Fitsb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fperformant-software%2Fitsb/lists"}