{"id":22455233,"url":"https://github.com/dijevic/cashys","last_synced_at":"2025-07-11T02:33:46.008Z","repository":{"id":124852958,"uuid":"462501885","full_name":"dijevic/Cashys","owner":"dijevic","description":"Cashys Backend","archived":false,"fork":false,"pushed_at":"2022-04-26T00:26:48.000Z","size":209,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-27T13:17:28.832Z","etag":null,"topics":["api","api-rest","backend","backend-api","backend-services","express","javascript","jwt-authentication","nodejs","sequelize-orm"],"latest_commit_sha":null,"homepage":"https://cashys.netlify.app/","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/dijevic.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":"2022-02-22T22:52:47.000Z","updated_at":"2023-03-07T07:53:31.000Z","dependencies_parsed_at":"2023-08-09T07:02:45.956Z","dependency_job_id":null,"html_url":"https://github.com/dijevic/Cashys","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/dijevic/Cashys","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dijevic%2FCashys","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dijevic%2FCashys/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dijevic%2FCashys/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dijevic%2FCashys/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dijevic","download_url":"https://codeload.github.com/dijevic/Cashys/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dijevic%2FCashys/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264713036,"owners_count":23652707,"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":["api","api-rest","backend","backend-api","backend-services","express","javascript","jwt-authentication","nodejs","sequelize-orm"],"created_at":"2024-12-06T07:10:55.346Z","updated_at":"2025-07-11T02:33:45.992Z","avatar_url":"https://github.com/dijevic.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eHi ! this is the CASHYS backend 😎 \u003c/h1\u003e\n\n\u003ch3 color=\"#fff\" align=\"center\"\u003eA complete backend service for the cashys app \u003c/h3\u003e\n\n \u003cbr/\u003e\n\nThe project has been done with _Node js_, _Express js_, _mysql_ , _sequelize_ \u0026 _HEROKU_ for storage and _Clever Cloud_ to storage the DB\n\n**The main idea of this project was to create an API and a full backend service , to deal with all necessary things to keep on track a money balance and their incomes and debts.**\n\nBesides this, an _auth service_ is done to cope with authentication and being able do a **CRUD for operations, balances and categories by an specific user**\u003c/p\u003e\n\nFor authentication i used **JWT**, to deal with the server i used **express js** , to handle the DB storage **clever cloud** and to storage ther rest-server the well known **Heroku**\n\nFinally I worked with the ORM **Sequelize** to deal with the DB petitions\n\n  \u003cbr/\u003e\n\n**to see the API documentation :**\n[Cashys documentation](https://documenter.getpostman.com/view/12181072/UVyswbFu)\n\n**To start with this project in local :**\n\n_First step :_\n\n- Copy and paste the following code on your Command Prompt :\n\n```\n https://github.com/dijevic/Cashys.git\n```\n\n_Second step :_\n\n- Navigate to the folder.\n\n```\n cd Cashys\n```\n\n- Open the folder on your favorite IDE\n\n```\n code .\n\n```\n\n_install all the dependencies :_\n\n```\n npm install\n```\n\n_Create a **.ENV** file:_\n\n- You should create the following env vars:\n\n```\nPORT=4000\nPRIVATESECRETJWTKEY=dummypassword\nEMAILUSER=dummyemailuser\nEMAILTRANSPORTERKEY=dummyemailkey\n```\n\nNOTE : **EMAILUSER** and **EMAILTRANSPORTERKEY** env vars are useful for using the auth functions(like create an user or recover a password ) , basically youll need to know how to setup nodemailer with google(because i am using gmail for sending the emails)\n\n\u003cbr/\u003e\n\u003cbr/\u003e\n\n_Run the code :_\n\n- To be able to run the code without DB problems, please first create a Mysql or Maria DB database in your local computer with the name : **cashy** , password: **null** and user: **root**\n\nNOTE : the params _name_,_password_,_user_ are not mandatory with these names but the development mode has been setted up with these name, if you want to change it just go to the db config file and change the respectives names\n\n\u003cbr/\u003e\n\u003cbr/\u003e\n\n- Once you have setted up your database run in your command Prompt the next code :\n\n```\nnpm run dev\n```\n\nThere you go, you should see some logs in your Command Prompt about connection.\n\nIf you want , you can visit the alive project already working :\n[Go to cashys](https://cashys.netlify.app/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdijevic%2Fcashys","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdijevic%2Fcashys","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdijevic%2Fcashys/lists"}