{"id":19272297,"url":"https://github.com/sdslabs/studyportal-axion","last_synced_at":"2025-04-21T22:31:23.495Z","repository":{"id":44591234,"uuid":"189960342","full_name":"sdslabs/studyportal-axion","owner":"sdslabs","description":"The ReactJS frontend for Study Portal","archived":false,"fork":false,"pushed_at":"2023-01-28T03:27:19.000Z","size":60145,"stargazers_count":22,"open_issues_count":12,"forks_count":0,"subscribers_count":11,"default_branch":"master","last_synced_at":"2024-05-28T00:27:09.355Z","etag":null,"topics":["frontend","javascript","react","redux","scss"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/sdslabs.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":"2019-06-03T07:56:05.000Z","updated_at":"2024-01-06T12:32:10.000Z","dependencies_parsed_at":"2023-02-15T14:16:19.950Z","dependency_job_id":null,"html_url":"https://github.com/sdslabs/studyportal-axion","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sdslabs%2Fstudyportal-axion","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sdslabs%2Fstudyportal-axion/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sdslabs%2Fstudyportal-axion/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sdslabs%2Fstudyportal-axion/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sdslabs","download_url":"https://codeload.github.com/sdslabs/studyportal-axion/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223881292,"owners_count":17219262,"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":["frontend","javascript","react","redux","scss"],"created_at":"2024-11-09T20:36:12.339Z","updated_at":"2024-11-09T20:36:12.980Z","avatar_url":"https://github.com/sdslabs.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# StudyPortal Front-End\n\nStudyportal-axion is the frontend application for the Studyportal application. This repositiory contains all the front-end code.\n\nThe application is avaliable at studysdslabs.co.\n\n## Pre-Requisites:\n\n1. Node.js + npm\n1. Docker(optional)\n1. Make a new file .env and copy .env.sample to .env\n\n## Local Development\n\nRun the following commands in order to have the code up and running on your machine:\n\n```bash\n# installs dependencies\nnpm install\n\n# Builds and serves assets with hot-reload\nnpm start\n```\n\n## Docker setup\n\nAlternatively, you can use Docker to build and run the application. You just have to run:\n\n```bash\ndocker-compose -f docker-compose-dev.yml up\n```\n\nYou should now have the application running and accessible at http://localhost:3005.\n\nYou will need to setup the studyportal-nexus locally to get the api for testing the application locally. You can find the instructions for the API setup at [studyportal-nexus](https://github.com/sdslabs/studyportal-nexus).\n\n## Localhost Tunneling\n\nIf you want to make your local development server accessible to the internet (for testing or showing someone something you're working on), you can use [`ngrok`](https://ngrok.com/). Follow the documentation on the `ngrok` site to install it and set it up. Once you have it installed, get the development server for Openverse running and in a separate window/tab, run:\n\n```\n# The extra parameters are required to ensure that ngrok redirects to the HTTPS version of the site\n# and that the host header matches one that is accepted by the server\n# (ngrok's default hostname is randomly generated and is not whitelisted).\nngrok http http://localhost:3005 -host-header=\"localhost:3005\"\n```\n\nIf you need to run an HTTP version (for example, if you're testing against third-party websites that do not accept the self-signed certificate generated by the dev server), run the dev server using `npm start` and use the following command to start `ngrok`:\n\n```\nngrok http 3005 -host-header=\"localhost:3005\"\n```\n\n## Formatting and Linting\n\nThe code in this repository is formatted using `prettier`. If you have prettier setup in your code editor it should work out of the box; otherwise you can use the `npm run lintfix` script to format and fix lint errors in your code. Checks are run to lint your code and validate the formatting on git precommit using [husky](https://github.com/typicode/husky).\n\nYou will need to fix any linting issues before committing. We recommend formatting your JavaScript files on save in your text editor. You can learn how to do this in Visual Studio Code [here](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode#format-on-save).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsdslabs%2Fstudyportal-axion","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsdslabs%2Fstudyportal-axion","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsdslabs%2Fstudyportal-axion/lists"}