{"id":19732381,"url":"https://github.com/terminusdb/terminusdb-dashboard","last_synced_at":"2025-04-30T02:32:22.493Z","repository":{"id":49766266,"uuid":"517972406","full_name":"terminusdb/terminusdb-dashboard","owner":"terminusdb","description":"Dashboard for TerminusDB","archived":false,"fork":false,"pushed_at":"2024-05-30T10:12:42.000Z","size":14614,"stargazers_count":6,"open_issues_count":21,"forks_count":6,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-05T21:51:11.519Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","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/terminusdb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2022-07-26T08:16:08.000Z","updated_at":"2024-04-29T19:44:19.000Z","dependencies_parsed_at":"2023-12-05T16:42:52.156Z","dependency_job_id":"fa671ddd-3647-4f09-b07b-8d4370fc3ac9","html_url":"https://github.com/terminusdb/terminusdb-dashboard","commit_stats":null,"previous_names":[],"tags_count":35,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/terminusdb%2Fterminusdb-dashboard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/terminusdb%2Fterminusdb-dashboard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/terminusdb%2Fterminusdb-dashboard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/terminusdb%2Fterminusdb-dashboard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/terminusdb","download_url":"https://codeload.github.com/terminusdb/terminusdb-dashboard/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251629228,"owners_count":21618126,"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-12T00:26:08.071Z","updated_at":"2025-04-30T02:32:21.414Z","avatar_url":"https://github.com/terminusdb.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# terminusdb-dashboard\n\nDashboard for TerminusDB. Monorepo for the TerminusDB dashboard components. Please see the individual packages for more\ndetails. The main dashboard package can be found in `packages/tdb-dashboard`.\n\n## Setting up terminusdb-dashboard\n\n**Clone the repository**\n\n```sh\ngit clone https://github.com/terminusdb/terminusdb-dashboard.git\n```\n\n**Install all the dependencies**\n\n```sh\ncd terminusdb-dashboard\nnpm install\n```\n\n**Build the dashboard**\n\nRename ENV.local to .env\n```sh\ncd terminusdb-dashboard/packages/tdb-dashboard\ncp ENV.local .env\n\nnpm run build\n```\nYou can find the built version into terminusdb-dashboard/packages/tdb-dashboard/dist\n\n**Locally Developing the dashboard**\n\nRunning `npm run start` instead of `build` starts a server and watches for changes. Because of the way this is configured, you will need to go to `/dashboard` after connecting in browser\n\n```sh\nnpm run start\n```\n\nThere are some differences depending on how you are developing it, if you are just running the dashboard repo locally:\n\n- Comment out the `@terminusdb/terminusdb-client` alias in the webpack config\n- Update the env file to have the `BASE_URL` be empty (also generally useful since this is where the webpack server opens the new browser window), this will mean you don't have to go to `/dashboard` as above\n\nThere is some additional configuration needed if you are wanting to run with Auth0 Login, essentially you just need a proxy and to setup the right auth0 config. This will allow you to login but the token generated will not be valid so you will need to replace it manually with a valid one.\n\n## Publishing\n\nTo release a new version, simply follow these steps:\n\n1. Create a new branch for the release\n2. Run `npm version NEW_VERSION_HERE --ws`, this will increment the version on all the packages inside\n   their package.json and package-lock.json files.\n3. Commit these new package.json files\n4. Make a PR, make sure the tests pass and let someone else code-review and approve\n5. Merge the PR to main and wait for the tests to pass\n6. Tag the new release with `git tag vYOUR_VERSION_NUMBER` (for example: `git tag v5.0.0`) in you local machine\n   and push the tag in git `git push origin vYOUR_VERSION_NUMBER`\n7. The packages are now on npm\nHow to use the terminusdb dashboard source code with your local terminusdb instance.\n\n\n\n\n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fterminusdb%2Fterminusdb-dashboard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fterminusdb%2Fterminusdb-dashboard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fterminusdb%2Fterminusdb-dashboard/lists"}