{"id":13727515,"url":"https://github.com/cc-archive/cccatalog-frontend","last_synced_at":"2025-05-07T22:31:26.101Z","repository":{"id":49628286,"uuid":"139915408","full_name":"cc-archive/cccatalog-frontend","owner":"cc-archive","description":"[PROJECT TRANSFERRED] CC Search is a search tool for CC-licensed and public domain content across the internet.","archived":true,"fork":false,"pushed_at":"2024-04-25T17:51:20.000Z","size":185293,"stargazers_count":164,"open_issues_count":0,"forks_count":196,"subscribers_count":33,"default_branch":"main","last_synced_at":"2024-12-14T15:05:31.253Z","etag":null,"topics":["cc-search","creative-commons","discontinued","frontend","javascript","vue"],"latest_commit_sha":null,"homepage":"https://github.com/WordPress/openverse-frontend","language":"Vue","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/cc-archive.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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":"2018-07-06T00:51:38.000Z","updated_at":"2024-12-12T07:12:59.000Z","dependencies_parsed_at":"2024-08-03T01:30:21.875Z","dependency_job_id":"3108a793-8a52-4a9b-baba-3523bc51f2c2","html_url":"https://github.com/cc-archive/cccatalog-frontend","commit_stats":null,"previous_names":["creativecommons/cccatalog-frontend"],"tags_count":75,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cc-archive%2Fcccatalog-frontend","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cc-archive%2Fcccatalog-frontend/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cc-archive%2Fcccatalog-frontend/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cc-archive%2Fcccatalog-frontend/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cc-archive","download_url":"https://codeload.github.com/cc-archive/cccatalog-frontend/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252965482,"owners_count":21832897,"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":["cc-search","creative-commons","discontinued","frontend","javascript","vue"],"created_at":"2024-08-03T01:04:03.213Z","updated_at":"2025-05-07T22:31:21.088Z","avatar_url":"https://github.com/cc-archive.png","language":"Vue","funding_links":[],"categories":["Vue"],"sub_categories":[],"readme":"--------\n# Project Transferred\n**This project was transfered to WordPress:**\n- **[WordPress/openverse-frontend](https://github.com/WordPress/openverse-frontend): The gateway to the Openverse. Openverse is a search tool for CC-licensed and public domain content across the internet.**\n\nFor additional context see:\n- 2020-12-07: [Upcoming Changes to the CC Open Source Community — Creative Commons Open Source](https://opensource.creativecommons.org/blog/entries/2020-12-07-upcoming-changes-to-community/)\n- 2021-05-03: [CC Search to Join WordPress - Creative Commons](https://creativecommons.org/2021/05/03/cc-search-to-join-wordpress/)\n- 2021-05-10: [Welcome to Openverse – Openverse — WordPress.org](https://make.wordpress.org/openverse/2021/05/11/hello-world/)\n- 2021-12-13: [Dear Users of CC Search, Welcome to Openverse - Creative Commons](https://creativecommons.org/2021/12/13/dear-users-of-cc-search-welcome-to-openverse/)\n--------\n\n# cccatalog-frontend\n\n![cccatalog-frontend-ci](https://github.com/creativecommons/cccatalog-frontend/workflows/cccatalog-frontend-ci/badge.svg)\n\nCC Search is the official web application for the [Creative Commons Catalog API\n](https://github.com/creativecommons/cccatalog-api). CC Search is an interface to search for content that is licensed under Creative Commons licenses or marked with public domain tools. This repositiory contains all the front-end code.\n\nThe application is avaliable at [search.creativecommons.org](https://search.creativecommons.org/).\n\n## Technology\n\nThe frontend app is built using [Vue.JS](https://vuejs.org/) and [NuxtJS](https://nuxtjs.org). You can [learn more about the migration to Nuxt.js here](/CODEBASE.md).\n\nThe user interface is powered by [Vocabulary](https://github.com/creativecommons/vocabulary), Creative Common's design system. If you have an issue with colors or a specific ui component, it should probably go in that repository.\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 run dev\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 up\n```\n\nYou should now have the application running and accessible at http://localhost:8443.\n\nYou don't need to have the CC Search API running locally to be able to run the frontend application. It's configured to communicate, by default, with the [API](https://api.creativecommons.engineering) that's already publicly available. If you wish, you can change the URL of the API that's used during development by setting the `API_URL` environment variable.\n\n### Running tests\n\nYou can run the unit tests by executing:\n\n```bash\nnpm run test\n```\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 CC Search 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:8443 -host-header=\"localhost:8443\"\n```\n\nIf you need to run a HTTP version (for example, if you're testing against third-party websites that do not accept the self-signed cerificate generated by the dev server), run the dev server using `npm run dev` and use the following command to start `ngrok`:\n\n```\nngrok http 8443 -host-header=\"localhost:8443\"\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 precomit using [husky](https://github.com/typicode/husky).\n\nYou will need to fix any linting issues before comitting. We reccommend 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\n## Versioning\n\nCC Search uses [CalVer](https://calver.org/) for version numbering, in the `YYYY.M.Micro` format. This format is intentionally compatiable with NPM's `semver` parser. `Micro` is bumped whenever there are multiple releases in a month, for example `2020.07.1` is the first release in July 2020, while `2020.07.2` is the second.\n\n## Deployment\n\nDetails about how to deploy the frontend code can be found on the [CC Wiki](https://wikijs.creativecommons.org/tech/cc-search/frontend) (Accessible to CC Staff only).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcc-archive%2Fcccatalog-frontend","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcc-archive%2Fcccatalog-frontend","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcc-archive%2Fcccatalog-frontend/lists"}