{"id":28957162,"url":"https://github.com/developmentseed/gl-director","last_synced_at":"2025-06-23T21:41:35.572Z","repository":{"id":47699094,"uuid":"319528118","full_name":"developmentseed/gl-director","owner":"developmentseed","description":"GL Director, an interface to easily generate terrain flyovers for your app using Mapbox GL JS","archived":false,"fork":false,"pushed_at":"2023-06-15T11:41:22.000Z","size":42810,"stargazers_count":23,"open_issues_count":4,"forks_count":7,"subscribers_count":8,"default_branch":"main","last_synced_at":"2024-04-10T03:11:35.956Z","etag":null,"topics":["3d","mapbox","mapbox-gl-js","terrain-rendering"],"latest_commit_sha":null,"homepage":"https://developmentseed.org/gl-director/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/developmentseed.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}},"created_at":"2020-12-08T04:43:42.000Z","updated_at":"2024-02-14T19:13:37.000Z","dependencies_parsed_at":"2022-08-22T18:41:01.350Z","dependency_job_id":null,"html_url":"https://github.com/developmentseed/gl-director","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/developmentseed/gl-director","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/developmentseed%2Fgl-director","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/developmentseed%2Fgl-director/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/developmentseed%2Fgl-director/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/developmentseed%2Fgl-director/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/developmentseed","download_url":"https://codeload.github.com/developmentseed/gl-director/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/developmentseed%2Fgl-director/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261561368,"owners_count":23177590,"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":["3d","mapbox","mapbox-gl-js","terrain-rendering"],"created_at":"2025-06-23T21:41:35.146Z","updated_at":"2025-06-23T21:41:35.532Z","avatar_url":"https://github.com/developmentseed.png","language":"JavaScript","readme":"# Mapbox GL Director\n\nAn interface to easily generate terrain flyovers for your app using [Mapbox GL JS](https://github.com/mapbox/mapbox-gl-js/)\n\n![main view of the application showing 3d map and user inputs](images/app.png)\n\n## Installation and Usage\n\nThe steps below will walk you through setting up your own instance of the project.\n\n### Install Project Dependencies\nTo set up the development environment for this website, you'll need to install the following on your system:\n\n- [Node](http://nodejs.org/) (see [.nvmrc](./.nvmrc)) (To manage multiple node versions we recommend [nvm](https://github.com/creationix/nvm))\n- [Yarn](https://yarnpkg.com/) Package manager\n\n### Install Application Dependencies\n\nIf you use [`nvm`](https://github.com/creationix/nvm), activate the desired Node version:\n\n```\nnvm install\n```\n\nInstall Node modules:\n\n```\nyarn install\n```\n\n### Usage\n\n#### Config files\nAll the config files can be found in `app/assets/scripts/config`.\nAfter installing the projects there will be 3 main files:\n  - `local.js` - Used only for local development. On production this file should not exist or be empty.\n  - `staging.js`\n  - `production.js`\n\nThe `production.js` file serves as base and the other 2 will override it as needed:\n  - `staging.js` will be loaded whenever the env variable `DS_ENV` is set to staging.\n  - `local.js` will be loaded if it exists.\n\nThe following options must be set: (The used file will depend on the context):\n  - `value` - Description\n\nExample:\n```\nmodule.exports = {\n  value: 'some-value'\n};\n```\n\n#### Starting the app\n\n```\nyarn serve\n```\nCompiles the javascript and launches the server making the site available at `http://localhost:9000/`\nThe system will watch files and execute tasks whenever one of them changes.\nThe site will automatically refresh since it is bundled with livereload.\n\n# Deployment\nTo prepare the app for deployment run:\n\n```\nyarn build\n```\nor\n```\nyarn stage\n```\nThis will package the app and place all the contents in the `dist` directory.\nThe app can then be run by any web server.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevelopmentseed%2Fgl-director","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevelopmentseed%2Fgl-director","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevelopmentseed%2Fgl-director/lists"}