{"id":26716605,"url":"https://github.com/67p/kredits-web","last_synced_at":"2025-04-14T01:40:23.334Z","repository":{"id":16886082,"uuid":"80489415","full_name":"67P/kredits-web","owner":"67P","description":"Kredits Web UI","archived":false,"fork":false,"pushed_at":"2025-02-17T06:46:46.000Z","size":20413,"stargazers_count":6,"open_issues_count":20,"forks_count":2,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-03-27T15:51:52.869Z","etag":null,"topics":["emberjs","kosmos","kredits","rsk"],"latest_commit_sha":null,"homepage":"https://kredits.kosmos.org","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/67P.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-01-31T03:57:45.000Z","updated_at":"2025-02-17T06:46:50.000Z","dependencies_parsed_at":"2023-11-17T14:43:58.261Z","dependency_job_id":"5a3cb129-dc9c-4918-b5b0-fc4737841c32","html_url":"https://github.com/67P/kredits-web","commit_stats":null,"previous_names":[],"tags_count":29,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/67P%2Fkredits-web","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/67P%2Fkredits-web/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/67P%2Fkredits-web/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/67P%2Fkredits-web/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/67P","download_url":"https://codeload.github.com/67P/kredits-web/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248809038,"owners_count":21164893,"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":["emberjs","kosmos","kredits","rsk"],"created_at":"2025-03-27T15:37:59.419Z","updated_at":"2025-04-14T01:40:23.311Z","avatar_url":"https://github.com/67P.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build Status](https://github.com/67P/kredits-web/actions/workflows/ci.yml/badge.svg)](https://github.com/67P/kredits-web/actions/workflows/ci.yml?query=branch%3Amaster)\n\n# Kredits Web\n\nThis is the main Web UI for Kosmos [Kredits](https://wiki.kosmos.org/Kredits).\nIt provides an overview of contributors and contributions, as well as the\ncommunity's budget, expenses, and reimbursements.\n\nIt is an unhosted Web app, fetching all data from\n[Rootstock](https://rootstock.io/) and [IPFS](https://ipfs.tech/), and caching\nit in the browser's local database. As such, you can run the app directly from\nthe `/release` directory on any Web server that can serve static assets.\n\n## Development\n\n### Prerequisites\n\nYou will need the following things properly installed on your computer.\n\n* [Git](https://git-scm.com/)\n* [Node.js](https://nodejs.org/) (with npm)\n* [Ember CLI](https://ember-cli.com/)\n* [Google Chrome](https://google.com/chrome/) (only for running tests)\n\n### Installation\n\n* `git clone git@github.com:67P/kredits-web.git` this repository\n* `cd kredits-web`\n* `npm install`\n\n### Building/running for development\n\n* `npm start` - by default Kredits Web connects to the Rootstock testnet network\n* Visit the app at [http://localhost:4200](http://localhost:4200).\n* Visit the tests at [http://localhost:4200/tests](http://localhost:4200/tests).\n\nSee [working with locally deployed contracts](https://github.com/67P/kredits-web#working-with-locally-deployed-contracts) for details on how to develop with locally deployed contracts.\n\n### Code generators\n\nMake use of the many generators for code, try `ember help generate` for more details\n\n### Running tests\n\n* `ember test`\n* `ember test --server`\n\n### Linting\n\n* `npm run lint:hbs`\n* `npm run lint:js`\n* `npm run lint:js -- --fix`\n\n### Building\n\n* `ember build` (development)\n* `npm run build` (production)\n\n### Deploying\n\n_(You need collaborator permissions on the 5apps Deploy project.)_\n\n`npm run deploy`\n\n### Working with locally deployed contracts\n\nThe smart contracts and their JavaScript wrapper library are developed in the\n[kredits-contracts](https://github.com/67P/kredits-contracts) repo/package.\n\nYou can run `kredits-web` on your machine, against a local, simulated\nblockchain. [kredits-contracts](https://github.com/67P/kredits-contracts)\ncontains all the tools to start and set up such a simulated network, as well as\nto deploy the Kredits smart contracts to it.\n\nThese are the basic steps to get up and running:\n\n#### 1. IPFS\n\nRun a local IPFS deamon.\n\n  * Make sure CORS headers are configured. See [IPFS](#ipfs) for more info.\n  * `ipfs daemon`\n\n#### 2. kredits-contracts\n\nRun a local devchain with test data. (See [kredits-contracts\nREADME](https://github.com/67P/kredits-contracts) for details.\n\n  * Clone [kredits-contracts](https://github.com/67P/kredits-contracts)\n  * `npm install`\n  * `npm run devchain` - runs a local development chain\n  * `npm run bootstrap` - deploys all contracts and seeds test data\n  * `npm link` - makes the `kredits-contracts` module linkable as `kredits-contracts` on your machine\n\n#### 3. kredits-web\n\nWith IPFS and the local devchain running, you can now link the contracts and\nstart the Ember app:\n\n  * `npm link kredits-contracts` - links the local `kredits-contracts` package (has to be done again after every `npm install`)\n  * `npm run start:local` - runs the Ember app with WEB3_PROVIDER_URL=http://localhost:8545 set\n\n#### 4. Metamask network\n\nIf you want to interact with the local contracts via a Web3 wallet, switch the\nnetwork to a \"Custom RPC\" one, with the RPC URL `http://localhost:8545`.\n\n#### IPFS\n\nIf you haven't configured your IPFS node for CORS yet, you can do so by running\nthe following commands:\n\n    ipfs config --json API.HTTPHeaders.Access-Control-Allow-Origin '[\"localhost:4200\"]'\n    ipfs config --json API.HTTPHeaders.Access-Control-Allow-Methods '[\"PUT\", \"GET\", \"POST\"]'\n    ipfs config --json API.HTTPHeaders.Access-Control-Allow-Credentials '[\"true\"]'\n    ipfs config Addresses.Gateway /ip4/127.0.0.1/tcp/8080\n\n## Further Reading / Useful Links\n\n* [ember.js](https://emberjs.com/)\n* [ember-cli](https://ember-cli.com/)\n* Development Browser Extensions\n  * [ember inspector for chrome](https://chrome.google.com/webstore/detail/ember-inspector/bmdblncegkenkacieihfhpjfppoconhi)\n  * [ember inspector for firefox](https://addons.mozilla.org/en-US/firefox/addon/ember-inspector/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F67p%2Fkredits-web","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F67p%2Fkredits-web","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F67p%2Fkredits-web/lists"}