{"id":20426509,"url":"https://github.com/futurestudio/nodejs-account-boilerplate","last_synced_at":"2026-03-13T14:32:45.216Z","repository":{"id":12235443,"uuid":"14846661","full_name":"futurestudio/nodejs-account-boilerplate","owner":"futurestudio","description":"OUTDATED. Boilerplate for new node.js projects with account handling and REST API","archived":false,"fork":false,"pushed_at":"2019-01-22T21:54:07.000Z","size":398,"stargazers_count":7,"open_issues_count":6,"forks_count":5,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-19T20:53:05.433Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://futurestud.io","language":"JavaScript","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/futurestudio.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-12-01T21:34:04.000Z","updated_at":"2020-04-14T09:12:18.000Z","dependencies_parsed_at":"2022-09-24T13:21:10.383Z","dependency_job_id":null,"html_url":"https://github.com/futurestudio/nodejs-account-boilerplate","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/futurestudio/nodejs-account-boilerplate","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/futurestudio%2Fnodejs-account-boilerplate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/futurestudio%2Fnodejs-account-boilerplate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/futurestudio%2Fnodejs-account-boilerplate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/futurestudio%2Fnodejs-account-boilerplate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/futurestudio","download_url":"https://codeload.github.com/futurestudio/nodejs-account-boilerplate/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/futurestudio%2Fnodejs-account-boilerplate/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30468312,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-13T11:00:43.441Z","status":"ssl_error","status_checked_at":"2026-03-13T11:00:23.173Z","response_time":60,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":[],"created_at":"2024-11-15T07:16:46.822Z","updated_at":"2026-03-13T14:32:45.195Z","avatar_url":"https://github.com/futurestudio.png","language":"JavaScript","readme":"\n# nodejs-account-boilerplate\n\n[![wercker status](https://app.wercker.com/status/e7c05973023d996d7ccdbe65c3c6307e/s/master \"wercker status\")](https://app.wercker.com/project/bykey/e7c05973023d996d7ccdbe65c3c6307e)\n\n\n## Futureflix\n`nodejs-account-boilerplate` is outdated and currently unmaintained. You can still benefit from the ideas within this code.\n\nWe started **[learn hapi](http://learnhapi.com) as a learning path for the hapi web framework**. Become a hapi hero by following the tutorial series.\n\n\u003cp\u003e\n  \u003ca href=\"http://learnhapi.com\"\u003e\t\n    \u003cimg src=\"https://futurestud.io/images/badges/hapi-hero-md.svg\" height=\"30\" /\u003e\t\n  \u003c/a\u003e\n\u003c/p\u003e\n\nYou’ll build a complete app from start to finish. From zero to hero!\n\nCheck out the [Futureflix Starter Kit](https://github.com/fs-opensource/futureflix-starter-kit) for more details :tv:\n\n\n-----\n\n\n## Project Overview\nThis is a boilerplate for new projects based on node.js and MongoDB. It reduces the initial effort so you can start with the fun things, and not implement an account system for the 24th time. It also comes with required basic functionality, like access to the appropriate database based on the node-environment or internationalization.\n\nThis boilerplate is still under active development.\n\nIt has the following features (might be incompete):\n\n- Accounts\n  - Create new account\n    - E-Mail/Password\n    - via facebook (soon)\n  - Edit account information\n  - Change password\n  - Secure forgot password reset\n  - Session tracking for website\n  - Blowfish-based password encryption (every password is hashed with an individual salt)\n\n- Environment-based database access\n  - set a different DB for development than production (or any stage you want)\n\n- Full test coverage\n\n- Internationalization\n  - the website views (/public/views) display how to offer the website in multiple languages\n  - the internationalization is currently incomplete, e.g. error message \u0026 API returns are currently only in English\n\n## API\nThe boilerplate does not only provide you with a website and the necessary server functions, it also has a REST API to handle the account related things. Adding new endpoints is fast and easy. Perfect for new projects with mobile apps (or any platform which is able to send HTTP requests and de/serialize JSON).\n\n- Requests are authenticated with a token (not username/password)\n- The requests from the REST API and the website run against the same business logic, just the handling is different (see account methods as an example for new endpoints)\n\nA fully functional android app boilerplate which uses the provided APIs is [available here](https://github.com/fs-opensource/android-boilerplate).\n\n## Stack\nYou need the following core technologies to run **nodejs-account-boilerplate**:\n- NodeJS\n- MongoDB\n\nBesides the core technologies it uses major components (this list is very likely incomplete):\n\n* [Express.js](http://expressjs.com/) - Node.js Web Framework\n* [Jade](http://jade-lang.com/) - HTML Templating Engine\n* [EmailJS](http://github.com/eleith/emailjs) - Node.js \u003e SMTP Server Middleware\n* [Bcrypt](https://npmjs.org/package/bcrypt-nodejs) - For password encryption\n* [FontAwesome](http://fortawesome.github.io/Font-Awesome/) - The iconic font designed for Bootstrap\n* [Twitter Bootstrap](http://twitter.github.com/bootstrap/) - UI Component \u0026 Layout Library\n* [Mocha](https://npmjs.org/package/mocha) - node.js Testing framework\n\nThe website is based on the [Modern Business template](http://startbootstrap.com/templates/modern-business/).\n\n## Install\nYou have install NodeJS dependencies before usage\n\n```\ngit clone git@github.com:fs-opensource/nodejs-account-boilerplate.git\ncd nodejs-account-boilerplate\nnpm install\n```\n\nConfigure MongoDB server connection\n```\nnano server/settings/db.js\n```\n\nConfigure E-Mail smtp server connection\n```\nnano server/settings/email.js\n```\n\nStart NodeJS server\n```\nnode server\n```\n\nIf everything is set up correctly, visit\n```\nlocalhost:3000\n```\n\n### Tests\n\nThe provided functions are thoroughly tested. Run\n\n```\nmocha test\n```\n\nfor our provided tests.\n\n### REST API\n\nA request to the REST API to signup a new user could look like this (use a tool like [postman](http://getpostman.com/) to quickly test the API):\n\n```\nPOST /api/user/signup HTTP/1.1\nHost: localhost:3000\nContent-Type: application/json\n\n{ \n  \"email\":\"testuser@gmail.com\",\n  \"phone\":\"0123456789\",\n  \"password\":\"password\"\n}\n```\n\nA full API documentation is available on Github at [/docs/api-docs](https://github.com/fs-opensource/nodejs-account-boilerplate/tree/develop/docs/api-doc)\n\n### nginx\n\nIn case you're running the boilerplate on a nginx server, you might need to change the [Underscores in Headers](http://nginx.org/en/docs/http/ngx_http_core_module.html#underscores_in_headers) setting to on:\n\n```\nunderscores_in_headers on\n```\n\nWe are using underscores in some header parameters for the API. If you don't turn it on, the headers will be ignored and it won't work as expected.\n\n## Contributions\n\nWe very warmly welcome any contributions. If it's bugs, feature requests or implementation, we enjoy feedback :)\n\n## License\n\n```\nThe MIT License (MIT)\n\nCopyright (c) 2014 Future Studio (futurestud.io)\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of \nthis software and associated documentation files (the \"Software\"), to deal in\nthe Software without restriction, including without limitation the rights to\nuse, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of\nthe Software, and to permit persons to whom the Software is furnished to do so,\nsubject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS\nFOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR\nCOPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER\nIN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN\nCONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n```\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffuturestudio%2Fnodejs-account-boilerplate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffuturestudio%2Fnodejs-account-boilerplate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffuturestudio%2Fnodejs-account-boilerplate/lists"}