{"id":19292165,"url":"https://github.com/nasa-pds/s3-browser-awssdk","last_synced_at":"2026-05-16T04:39:10.989Z","repository":{"id":219846020,"uuid":"750043027","full_name":"NASA-PDS/s3-browser-awssdk","owner":"NASA-PDS","description":"Use the aws-sdk to browse an s3 bucket contents.","archived":false,"fork":false,"pushed_at":"2024-11-29T23:12:29.000Z","size":149,"stargazers_count":0,"open_issues_count":3,"forks_count":1,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-01-05T20:26:47.337Z","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":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NASA-PDS.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-01-29T21:56:03.000Z","updated_at":"2024-07-24T16:54:01.000Z","dependencies_parsed_at":"2024-01-30T02:04:32.330Z","dependency_job_id":"65322d0e-aa46-472c-b17d-3dfea4d14c46","html_url":"https://github.com/NASA-PDS/s3-browser-awssdk","commit_stats":null,"previous_names":["nasa-pds/s3-browser","nasa-pds/s3-browser-awssdk"],"tags_count":0,"template":false,"template_full_name":"NASA-PDS/template-repo-nodejs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NASA-PDS%2Fs3-browser-awssdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NASA-PDS%2Fs3-browser-awssdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NASA-PDS%2Fs3-browser-awssdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NASA-PDS%2Fs3-browser-awssdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NASA-PDS","download_url":"https://codeload.github.com/NASA-PDS/s3-browser-awssdk/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240395824,"owners_count":19794582,"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-11-09T22:29:32.145Z","updated_at":"2026-05-16T04:39:05.970Z","avatar_url":"https://github.com/NASA-PDS.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📽️ PDS S3-Browser\n\nThis react app allows browsing of an s3 bucket's contents using the aws-sdk. It is based on the aws-sdk examples from amazon.\n\nhttps://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/javascript_s3_code_examples.html\n\nhttps://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/s3\n\n## 💽 Prerequisites\n\nWe recommend the use of [Node Version Manager (nvm)](https://github.com/nvm-sh/nvm), since different projects within the Planetary Data System require different versions of Node.js. This tool allows you to use a specific version of Node.js for each terminal session on your machine. **_If you haven't already, [install or update nvm](https://github.com/nvm-sh/nvm#installing-and-updating)._**\n\nOnce your `nvm` installation has been [verified](https://github.com/nvm-sh/nvm/blob/master/README.md#verify-installation), configured, and activated (see the [NVM README](https://github.com/nvm-sh/nvm#readme)), you can run the following commands\n\n    nvm use\n\nYou also need an aws account with an s3 bucket.\n\n## 🏎️ User Quickstart\n\nEdit 'App.tsx' with region, credentials and bucket name. You can get these from your aws account.\n\nThere are several ways to connect to s3 but for development purposes the temporary access keys and token is the fastest way.\n\nYou can quickly install this by typing\n\n    npm install\n\nTo execute, run:\n\n    npm run dev\n\n## ✋ Code of Conduct\n\nAll users and developers of the NASA-PDS software are expected to abide by our [Code of Conduct](https://github.com/NASA-PDS/.github/blob/main/CODE_OF_CONDUCT.md). Please read this to ensure you understand the expectations of our community.\n\n## 🔧 Development\n\nTo develop this project, use your favorite text editor, or an integrated development environment of your choice with Node.js support.\n\n### 👏 Contributing\n\nFor information on how to contribute to NASA-PDS codebases please take a look at our [Contributing guidelines](https://github.com/NASA-PDS/.github/blob/main/CONTRIBUTING.md).\n\n### 🤫 Detecting Secrets\n\nThe PDS Engineering Node recommends using [detect-secrets](https://github.com/NASA-PDS/nasa-pds.github.io/wiki/Git-and-Github-Guide#detect-secrets) in order to prevent credentials, private email addresses, application keys, etc., from leaking into the commit history. To use `detect-secrets`, install the tool according to the instructions in the wiki. Then, make a baseline for any secrets that are _supposed_ to be in repository:\n\n    detect-secrets scan . \\\n        --all-files \\\n        --disable-plugin AbsolutePathDetectorExperimental \\\n        --exclude-files '\\.secrets..*' \\\n        --exclude-files '\\.git.*' \\\n        --exclude-files '\\.pre-commit-config\\.yaml' \\\n        --exclude-files 'node_modules' \u003e .secrets.baseline\n\nReview the `.secrets.baseline` to determine which should be allowed and which are false positives:\n\n    detect-secrets audit .secrets.baseline\n\nPlease remove any secrets that should not be seen by the public. You can then add the baseline file to the commit:\n\n    git add .secrets.baseline\n\nThen, configure the `pre-commit` hooks:\n\n    pre-commit install\n    pre-commit install -t pre-push\n    pre-commit install -t prepare-commit-msg\n    pre-commit install -t commit-msg\n\nThese hooks then will check for any future commits that might contain secrets.\n\n👉 **Note:** A one time setup is required both to support `detect-secrets` and in your global Git configuration. See [the wiki entry on Secrets](https://github.com/NASA-PDS/nasa-pds.github.io/wiki/Git-and-Github-Guide#detect-secrets) to learn how.\n\n### 📦 Packaging\n\nEnter: `npm run build`.\n\n### 🩺 Tests\n\nUse `npm run tests`.\n\n## 📢 Publication\n\nThe continuous integration provided by the [Roundup Action](https://github.com/NASA-PDS/roundup-action/) takes care of this. But you can manually publish a release with `npm publish`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnasa-pds%2Fs3-browser-awssdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnasa-pds%2Fs3-browser-awssdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnasa-pds%2Fs3-browser-awssdk/lists"}