{"id":23478221,"url":"https://github.com/serknight/whale-book","last_synced_at":"2025-04-13T16:24:14.518Z","repository":{"id":269095849,"uuid":"906416848","full_name":"SerKnight/whale-book","owner":"SerKnight","description":"🐋 Palantir Foundry backed React app for discovering open source whale sightings","archived":false,"fork":false,"pushed_at":"2024-12-22T18:14:05.000Z","size":77,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-16T08:12:49.841Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","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/SerKnight.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,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-20T21:30:40.000Z","updated_at":"2024-12-22T18:14:08.000Z","dependencies_parsed_at":"2024-12-20T22:21:41.655Z","dependency_job_id":"8e098908-eae7-496c-8e41-c1ad104fa0a9","html_url":"https://github.com/SerKnight/whale-book","commit_stats":null,"previous_names":["serknight/whale-book"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SerKnight%2Fwhale-book","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SerKnight%2Fwhale-book/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SerKnight%2Fwhale-book/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SerKnight%2Fwhale-book/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SerKnight","download_url":"https://codeload.github.com/SerKnight/whale-book/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248742348,"owners_count":21154472,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":[],"created_at":"2024-12-24T19:17:10.283Z","updated_at":"2025-04-13T16:24:14.500Z","avatar_url":"https://github.com/SerKnight.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# WhaleTail 🐋\n\nA Palantir Foundry application for tracking and visualizing whale migration patterns using the Ontology SDK (OSDK). Built during the first Foundry DevCon.\n\n## Prerequisites\n\n- Node.js (v18+)\n- Palantir Foundry instance with appropriate access\n- Mapbox account (free tier works)\n- NPM registry access to Foundry artifacts\n\n## Installation\n\n1. Configure NPM registry:\n```bash\n# Add to .npmrc\n//\u003cinstance-artifact-registry\u003e:_authToken=${FOUNDRY_TOKEN}\n@whaletail:registry=\u003cinstance-artifact-registry\u003e\n```\n\n2. Install dependencies:\n```bash\nnpm install\n```\n\n3. Set up environment:\n```bash\ncp .env.example .env.development\n```\n\n4. Configure your `.env.development`:\n```bash\n# Foundry Configuration\nVITE_FOUNDRY_API_URL=https://\u003cyour-foundry-instance\u003e.palantirfoundry.com\nVITE_FOUNDRY_CLIENT_ID=\u003cyour-oauth-client-id\u003e\n\n# OAuth Configuration\nVITE_FOUNDRY_REDIRECT_URL=http://localhost:8080/auth/callback\nVITE_FOUNDRY_REDIRECT_URL_PROD=https://\u003cyour-domain\u003e/auth/callback\n\n# Mapbox Configuration\nVITE_MAPBOX_TOKEN=\u003cyour-mapbox-token\u003e\n```\n\n5. Start the development server:\n```bash\nnpm run dev\n```\n\n## Foundry Requirements\n\n### Required Resources\n1. **Pipeline**: `whale_data` for processing sighting data\n2. **Ontology Objects**:\n   - `Whales`: Profile management\n   - `WhaleActivity`: Sighting tracking\n3. **AIP Function**: `getWhale`\n4. **OSDK Resources**:\n   - Objects: `Whale`, `WhaleActivity`\n   - Actions: `CreateWhaleActivity`\n   - Functions: `getWhale`\n\n## Development\n\n```bash\n# Local development\nnpm run dev\n\n# Code Workspaces development\nnpm run dev:remote\n```\n\n## Tech Stack\n\n- Frontend: React, TypeScript, Vite\n- Visualization: MapboxGL\n- Styling: TailwindCSS\n- Backend: Palantir Foundry OSDK\n\n## Data Sources\n\n- [SEAMAP Duke](https://seamap.env.duke.edu/dataset/list)\n- [HappyWhale](https://instagram.com/happywhale_official)\n- [OBIS Network](https://x.com/obisnetwork)\n\n## Demo\n\nSee it in action: [Video Walkthrough](https://x.com/serknight_/status/1858900717462806582/video/1)\n\n## Documentation\n\n- [Palantir Foundry Docs](https://www.palantir.com/docs/foundry/)\n- [OSDK Documentation](https://www.palantir.com/docs/foundry/ontology-sdk/overview/)\n\n## License\n\n[Add your license here]\n\n---\nBuilt with 🐋 during Palantir Foundry DevCon","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fserknight%2Fwhale-book","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fserknight%2Fwhale-book","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fserknight%2Fwhale-book/lists"}