{"id":26847955,"url":"https://github.com/svsticky/magnificent-sloth","last_synced_at":"2025-07-15T06:45:02.373Z","repository":{"id":37191519,"uuid":"238179515","full_name":"svsticky/magnificent-sloth","owner":"svsticky","description":"Point of Sale for Dead Mongoose","archived":false,"fork":false,"pushed_at":"2024-11-26T12:33:00.000Z","size":5553,"stargazers_count":4,"open_issues_count":33,"forks_count":3,"subscribers_count":8,"default_branch":"development","last_synced_at":"2025-03-30T20:36:15.815Z","etag":null,"topics":["electron","hacktoberfest","nfc","point-of-sale"],"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/svsticky.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"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":"2020-02-04T10:27:54.000Z","updated_at":"2024-11-26T12:30:47.000Z","dependencies_parsed_at":"2024-11-30T15:18:43.739Z","dependency_job_id":null,"html_url":"https://github.com/svsticky/magnificent-sloth","commit_stats":null,"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/svsticky%2Fmagnificent-sloth","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/svsticky%2Fmagnificent-sloth/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/svsticky%2Fmagnificent-sloth/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/svsticky%2Fmagnificent-sloth/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/svsticky","download_url":"https://codeload.github.com/svsticky/magnificent-sloth/tar.gz/refs/heads/development","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251795389,"owners_count":21645019,"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":["electron","hacktoberfest","nfc","point-of-sale"],"created_at":"2025-03-30T20:36:17.323Z","updated_at":"2025-07-15T06:45:02.357Z","avatar_url":"https://github.com/svsticky.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# magnificent-sloth\nPoint of Sale for Dead Mongoose\n\n### How to install\n\n#### Prerequisites\nTo install the package locally, you first have to install `nvm`. Instructions can be found [here](https://github.com/nvm-sh/nvm#installing-and-updating).\nMake sure you install at least the latest LTS release.\nYou also need `libpcsclite-dev` and `pcscd`\n\n#### Install locally\n1. Clone the repo to a directory of your choice.\n1. Enter the directory: `cd /path/to/your/directory`.\n1. Follow the guide at \"Install NFC\" for making NFC Functional.\n1. Run `npm i`. This will use nvm that you've installed before.\n1. Copy over `sample.env` and name it `.env`: `cp sample.env .env` \n1. To update the values in `.env`, simply enter the file using your favorite editor, e.g. `nano .env`.\n1. Start the application with `npm start`.\n\n#### Update semantic-ui\nIf changes are made to files in the semantic folder, these changes will become active only after you run the following command:\n`npm run build-semantic`.\n\n#### Install NFC\nMaking a NFC Reader functional is quite a task so here is a guide how to make NFC Functional. When using Linux there is a driver in place for handling Smartcard readers. We don't use this driver so we have to disable it and use the driver provided with the native node module which has to be installed with some specific steps.\n\n1. If you want to use NFC-PCSC you should follow their [guide](https://www.npmjs.com/package/nfc-pcsc) on how to install the extension.\n1. Check if the smartcard reader is connected to your pc by running the command \n```console\nlsusb -t \n  /:  Bus 01.Port 1: Dev 1, Class=root_hub, Driver=xhci_hcd/12p, 480M\n      |__ Port 3: Dev 6, If 0, Class=Chip/SmartCard, Driver=pn533_usb, 12M\n          ...\n```\nThis should return something comperable to this. If you don't see `Class=Chip/SmartCard` The NFC reader is not recognized and should first troubleshoot this issue.\n1. In This case you can see the driver `pn533_usb` is being used. You dont want this since we use the driver provided with pcsclite. Run \n```console\nlsmod | grep pn533_usb\nModule                  Size  Used by\npn533_usb              20480  0\npn533                  45056  1 pn533_usb\nnfc                   131072  1 pn533\n```\nThis will return a list of drivers being used and these need to be disabled.\n1. Run `sudo nano /etc/modprobe.d` and insert all the modules likes this:\n```\npn533_usb\npn533\nnfc\n```\n1. Reboot your PC\n1. After restarting run these commands\n```\n# systemctl enable pcscd\n# systemctl start pcscd\n```\n\n#### Build application\nThe repository supports building a deb-package to be able to install the app on debian/ubuntu machines (or any derivatives). To create the deb-package, run the following command:\n\n`npm run build`\n\nThe deb-package can be found in dist/installers.\n\nWhen the deb-package is installed and opened via gnome, the application expects the environment file to be in `/home/$USERNAME`. Make sure you copy `sample.env` to this location, rename it to `.env`, and update its values.\nYou can also just run `source .env` to add your environment variables to the current shell session. Add it to your `.bashrc` to make it permanent.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsvsticky%2Fmagnificent-sloth","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsvsticky%2Fmagnificent-sloth","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsvsticky%2Fmagnificent-sloth/lists"}