A website and user system starter. Implemented with Hapi, React and Flux.
Server side, Aqua is built with the hapi.js framework and toolset. We're using MongoDB as a data store. We also use Nodemailer for email transport.
The front-end is built with React. We're using a totally vanilla Flux implementation. Client side routing is done with React Router. We're using Gulp for the asset pipeline.
| url | username | password |
|---|---|---|
| https://getaqua.herokuapp.com/ | root | root |
Note: The live demo has been modified so you cannot change the root user, the root user's linked admin role or the root admin group. This was done in order to keep the app ready to use at all times.
You need Node.js and MongoDB installed and running.
We use bcrypt for hashing
secrets. If you have issues during installation related to bcrypt then refer
to this wiki
page.
$ git clone [email protected]:jedireza/aqua.git && cd ./aqua
$ npm installWARNING: This will clear all data in existing users, admins and
adminGroups MongoDB collections. It will also overwrite /config.js if one
exists.
$ npm run setup
# > [email protected] setup /Users/jedireza/projects/aqua
# > ./setup.js
# Project name: (Aqua)
# MongoDB URL: (mongodb://localhost:27017/aqua)
# Root user email: [email protected]
# Root user password:
# System email: ([email protected])
# SMTP host: (smtp.gmail.com)
# SMTP port: (465)
# SMTP username: ([email protected])
# SMTP password:
# Setup complete.$ npm start
# > [email protected] start /Users/jedireza/projects/aqua
# > gulp react && gulp
# [23:41:44] Using gulpfile ~/projects/aqua/gulpfile.js
# [23:41:44] Starting 'react'...
# [23:41:44] Finished 'react' after 515 ms
# [23:41:45] Using gulpfile ~/projects/aqua/gulpfile.js
# [23:41:45] Starting 'watch'...
# [23:41:45] Finished 'watch' after 82 ms
# [23:41:45] Starting 'less'...
# [23:41:45] Finished 'less' after 15 ms
# [23:41:45] Starting 'webpack'...
# [23:41:45] Starting 'react'...
# [23:41:45] Starting 'nodemon'...
# [23:41:45] Finished 'nodemon' after 1.01 ms
# [23:41:45] Starting 'media'...
# [gulp] [nodemon] v1.3.7
# [gulp] [nodemon] to restart at any time, enter `rs`
# [gulp] [nodemon] watching: *.*
# [gulp] [nodemon] starting `node server.js`
# Started the plot device.
# [23:41:47] Finished 'media' after 2.16 s
# [23:42:01] [webpack] Hash: 746152d2793c42fb1240
# ...
# [23:42:01] Finished 'webpack' after 16 sThis will start the app using nodemon.
nodemon will watch for changes and restart the app as needed.
Now you should be able to point your browser to http://localhost:8000/ and see the welcome page.
- Create a website and user system
- Write code in a simple and consistent way
- It's just JavaScript
- 100% test coverage
- Basic front end web pages
- Contact page has form to email
- Account signup page
- Login system with forgot password and reset password
- Abusive login attempt detection
- User roles for accounts and admins
- Facilities for notes and status updates
- Admin groups with shared permissions
- Admin level permissions that override group permissions
Any issues or questions (no matter how basic), open an issue. Please take the initiative to include basic debugging information like operating system and relevant version details such as:
$ npm version
# { aqua: '0.0.0',
# npm: '2.5.1',
# http_parser: '2.3',
# modules: '14',
# node: '0.12.0',
# openssl: '1.0.1l',
# uv: '1.0.2',
# v8: '3.28.73',
# zlib: '1.2.8' }Contributions are welcome. Your code should:
- include 100% test coverage
- follow the hapi.js coding conventions
If you're changing something non-trivial, you may want to submit an issue first.
Lab is part of the hapi.js toolset and what we use to write all of our tests.
For command line output:
$ npm test
# > [email protected] test /Users/jedireza/projects/aqua
# > lab -c -L ./test/client-before.js ./test/client/ ./test/client-after.js ./test/misc/ ./test/server/
# ..................................................
# ..................................................
# ..................................................
# ..................................................
# ..................................................
# ..................................................
# ..................................................
# ..................................................
# ..................................................
# ..................................................
# ..................................................
# ..................................................
# ..................................................
# ..................................................
# ..................................................
# ..................................................
# ..................................................
# ..................................................
# ..................................................
# ..................................................
# ......
# 1006 tests complete
# Test duration: 11004 ms
# No global variable leaks detected
# Coverage: 100.00%
# Linting results: No issuesWith html code coverage report:
$ npm run test-cover
# > [email protected] test-cover /Users/jedireza/projects/aqua
# > lab -c -r html -o ./test/artifacts/coverage.html ./test/client-before.js ./test/client/ ./test/client-after.js ./test/misc/ ./test/server/ && open ./test/artifacts/coverage.htmlThis will run the tests and open a web browser to the visual code coverage
artifacts. The generated source can be found in /tests/artifacts/coverage.html.
MIT
What you build with Aqua is more important than Aqua.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent