Skip to content

Latest commit

 

History

History
118 lines (77 loc) · 5.03 KB

README.md

File metadata and controls

118 lines (77 loc) · 5.03 KB

FOSSology UI

GPL-2.0 Slack Channel YouTube Channel

About FOSSology

FOSSology is an open source license compliance software system and toolkit. As a toolkit, you can run license, copyright and export control scans from the command line. As a system, a database and web UI are provided to give you a compliance workflow. In one click you can generate an SPDX file or a ReadMe with all the copyrights notices from your software. FOSSology deduplication means that you can scan an entire distro, rescan a new version, and only the changed files will get rescanned. This is a big time saver for large projects.

Check out Who Uses FOSSology!

FOSSology does not give legal advice. https://fossology.org/

Overview

The UI Migration project is an effort focused on generating the new component-based architecture with the integration of the APIs. To make the project more efficient and easily accessible, an entire code base shift from Symfony-Twig to React.js is proposed. React.js features an incrementally adaptable architecture that focuses on declarative rendering and component composition. React.js component system will enable us to organize the current working APIs appropriately.

Objectives

  • Working on good interactive design, with a modern look.
  • Integrating the APIs to the new component-based UI structure.
  • Seamless routing and page transitions.
  • Giving the power of the node engine to our UI. Making all NPM accessible.
  • Writing detailed ​ documentation of the project, to make the codebase simpler for other contributors.

Requirements

NodeJS and NPM or yarn
https://nodejs.org/en/download/ https://yarnpkg.com/getting-started/install

Installation

Docker

FOSSology comes with a Dockerfile allowing the containerized execution.

Run the following commands inside the project directory.

docker build \
-t fossologyui:react1.0 \
--build-arg REACT_APP_SERVER_URL="localhost/repo/api/v2" \
--build-arg REACT_APP_HTTPS="false" .
docker run -p 3000:3000 fossologyui:react1.0

The docker image can then be used using http://IP_OF_DOCKER_HOST:3000/ user fossy password fossy.


In the project directory, you can run:

create a .env in root directory of project and copy the contents from .env.sample

yarn

yarn start

Runs the app in the development mode.
Open http://localhost:3000 to view it in the browser.

The page will reload if you make edits.
You will also see any lint errors in the console.

yarn test

Launches the test runner in the interactive watch mode.
See the section about running tests for more information.

yarn build

Builds the app for production to the build folder.
It correctly bundles React in production mode and optimizes the build for the best performance.

The build is minified and the filenames include the hashes.
Your app is ready to be deployed!

See the section about deployment for more information.

Support

Mailing lists, FAQs, Release Notes, and other useful info is available by clicking the documentation tab on the project website. We encourage all users to join the mailing list and participate in discussions. There is also a #fossology IRC channel on the freenode IRC network if you'd like to talk to other FOSSology users and developers. See Contact Us

Contributing

We really like contributions in several forms, see CONTRIBUTING.md

Licensing

FOSSology and FOSSologyUI are licensed under GPL-2.0

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; version 2 of the License

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

Please see the LICENSE file included with this software for the full texts of these licenses.