{"id":13548665,"url":"https://github.com/performant-software/neatline-spa","last_synced_at":"2025-04-02T21:32:04.261Z","repository":{"id":41813518,"uuid":"117136085","full_name":"performant-software/neatline-spa","owner":"performant-software","description":"Single page application for Neatline mapping interface","archived":true,"fork":false,"pushed_at":"2022-04-28T13:10:36.000Z","size":28802,"stargazers_count":4,"open_issues_count":73,"forks_count":2,"subscribers_count":10,"default_branch":"master","last_synced_at":"2024-08-06T16:10:50.495Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"CSS","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}},"created_at":"2018-01-11T18:17:28.000Z","updated_at":"2024-08-06T16:10:50.496Z","dependencies_parsed_at":"2022-08-11T18:11:28.521Z","dependency_job_id":null,"html_url":"https://github.com/performant-software/neatline-spa","commit_stats":null,"previous_names":["scholarslab/neatline-spa"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/performant-software%2Fneatline-spa","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/performant-software%2Fneatline-spa/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/performant-software%2Fneatline-spa/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/performant-software%2Fneatline-spa/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/performant-software","download_url":"https://codeload.github.com/performant-software/neatline-spa/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246895868,"owners_count":20851341,"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-08-01T12:01:12.998Z","updated_at":"2025-04-02T21:32:03.722Z","avatar_url":"https://github.com/performant-software.png","language":"CSS","funding_links":[],"categories":["CSS","others"],"sub_categories":[],"readme":"# neatline-3\n###### Front-end for neatline-omeka-s plugin\n\n## Development\nTo run the neatline-3 app as a independent single page application, use:\n```\nyarn start\n```\nThis will start a new development server at `http://localhost:3000`.\n\n***\n\nTo run the neatline-3 app integrated with Omeka S, set the `NODE_BUILD_DESTINATION` environment variable to the location of the `build` folder within your neatline-omeka-s project (i.e. `path/to/neatline-omeka-s/asset/neatline/build`), then use:\n```\nyarn run build \u0026\u0026 yarn run deploy\n```\nThis will create a new production build within the neatline-omeka-s project. Each time you make a change to one of the source files, this will need to be re-run.\n\n## Staging\nThe staging server setup process is documented in the [neatline-omeka-s](http://github.com/performant-software/neatline-omeka-s) repository.\n\n#### Git\nThe staging server is also setup as a Git server. This will allow developers to push changes to a remote repo and use Git hooks to update and deploy (much like Heroku).\n\nCreate the repository, we'll use a \"bare\" repository to allow pushes.\n```\ngit init --bare neatline-3.git\n```\n\nCreate the working directory, will be empty until a push is made.\n```\ngit clone neatline-3.git neatline-3\n```\n\nSetup the hooks directory\n```\ngit configre core.hooksPath /root/neatline-3/hooks\n```\n\nCreate a file for environment variables and populate `NODE_ENV`, `NODE_BUILD_DIR`, and `NODE_BUILD_DESTINATION`. These variables will be used in the post-receive hook to deploy the build. The .env file should be kept __outside__ of the neatline-3 directory so that it is not removed during hook execution.\n```\ntouch .env\nnano .env\n```\n\nGit will use the hooks feature to deploy the app after a push is made. See [post-recieve](hooks/post-receive) hook.\n\n#### Deployment\n\nAfter the initial setup of the staging server has been done, deployments can be done directly via Github.\n\nFirst, add the remote respository:\n```\ngit remote add staging root@142.93.114.34:neatline-3.git\n```\n\nThen, push your changes:\n```\ngit push staging \u003clocal-branch\u003e:\u003cremote-branch\u003e\ngit push staging my_awesome_feature:master\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fperformant-software%2Fneatline-spa","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fperformant-software%2Fneatline-spa","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fperformant-software%2Fneatline-spa/lists"}