Commit 033f9629918e5eaae0d554cc0937d49d50214f6d
1 parent
2cfb4bd0e1
Exists in
master
Update README with additional files, remove Not Added Yet
title from Authentication block, add Validation block.
Showing
1 changed file
with
5 additions
and
1 deletions
Show diff stats
README.md
| 1 | # The Meteor Chef - Base (@0.9.2.2) | 1 | # The Meteor Chef - Base (@0.9.2.2) |
| 2 | A starting point for Meteor apps. | 2 | A starting point for Meteor apps. |
| 3 | 3 | ||
| 4 | ### **This project is currently under heavy development and not recommended for use.** | 4 | ### **This project is currently under heavy development and not recommended for use.** |
| 5 | 5 | ||
| 6 | Base is the lazy person's starter kit for Meteor. It includes some commonly used packages (biased to The Meteor Chef) and code for common functionality. This is the starter kit for all Meteor Chef recipes. | 6 | Base is the lazy person's starter kit for Meteor. It includes some commonly used packages (biased to The Meteor Chef) and code for common functionality. This is the starter kit for all Meteor Chef recipes. |
| 7 | 7 | ||
| 8 | ### Packages Included | 8 | ### Packages Included |
| 9 | - Accounts (Base) - `meteor add accounts-base` | 9 | - Accounts (Base) - `meteor add accounts-base` |
| 10 | - Accounts (Password) - `meteor add accounts-password` | 10 | - Accounts (Password) - `meteor add accounts-password` |
| 11 | - Audit Argument Checks - `meteor add audit-argument-checks` | 11 | - Audit Argument Checks - `meteor add audit-argument-checks` |
| 12 | - Bootstrap 3 - `meteor add pinglamb:bootstrap3` | 12 | - Bootstrap 3 - `meteor add pinglamb:bootstrap3` |
| 13 | - Check - `meteor add check` | 13 | - Check - `meteor add check` |
| 14 | - CoffeeScript - `meteor add coffeescript` | 14 | - CoffeeScript - `meteor add coffeescript` |
| 15 | - Handlebars Server - `meteor add cmather:handlebars-server` | 15 | - Handlebars Server - `meteor add cmather:handlebars-server` |
| 16 | - Iron Router - `meteor add iron:router` | 16 | - Iron Router - `meteor add iron:router` |
| 17 | - jQuery - `meteor add jquery` | 17 | - jQuery - `meteor add jquery` |
| 18 | - Sass - `meteor add particle4dev:sass` | 18 | - Sass - `meteor add particle4dev:sass` |
| 19 | - Underscore - `meteor add underscore` | 19 | - Underscore - `meteor add underscore` |
| 20 | 20 | ||
| 21 | ### File Structure | 21 | ### File Structure |
| 22 | Base comes with a pre-defined file structure common to all projects along with some skeleton files for getting started quickly. Here's what it looks like: | 22 | Base comes with a pre-defined file structure common to all projects along with some skeleton files for getting started quickly. Here's what it looks like: |
| 23 | 23 | ||
| 24 | ``` | 24 | ``` |
| 25 | /root | 25 | /root |
| 26 | ---/.meteor | 26 | ---/.meteor |
| 27 | ---/client | 27 | ---/client |
| 28 | ------/controllers | 28 | ------/controllers |
| 29 | ---------/public | 29 | ---------/public |
| 30 | ------------login.coffee | 30 | ------------login.coffee |
| 31 | ------------signup.coffee | 31 | ------------signup.coffee |
| 32 | ------------recover-password.coffee | 32 | ------------recover-password.coffee |
| 33 | ------------reset-password.coffee | 33 | ------------reset-password.coffee |
| 34 | ------/helpers | 34 | ------/helpers |
| 35 | ---------helpers-ui.coffee | 35 | ---------helpers-ui.coffee |
| 36 | ------/layouts | 36 | ------/layouts |
| 37 | ---------layout-default.html | 37 | ---------layout-default.html |
| 38 | ------/routes | 38 | ------/routes |
| 39 | ---------filters.coffee | 39 | ---------filters.coffee |
| 40 | ---------routes-global.coffee | 40 | ---------routes-global.coffee |
| 41 | ---------routes-authenticated.coffee | 41 | ---------routes-authenticated.coffee |
| 42 | ---------routes-public.coffee | 42 | ---------routes-public.coffee |
| 43 | ------/stylesheets | 43 | ------/stylesheets |
| 44 | ---------/sass | 44 | ---------/sass |
| 45 | ------------/globals | 45 | ------------/globals |
| 46 | ---------------_extends.scss | 46 | ---------------_extends.scss |
| 47 | ------------/modules | 47 | ------------/modules |
| 48 | ------------/vendor | 48 | ------------/vendor |
| 49 | ------------/views | 49 | ------------/views |
| 50 | ---------------/authenticated | 50 | ---------------/authenticated |
| 51 | ---------------/public | 51 | ---------------/public |
| 52 | ------------------_login.scss | 52 | ------------------_login.scss |
| 53 | ---------application.scss | 53 | ---------application.scss |
| 54 | -------/views | 54 | -------/views |
| 55 | ---------/authenticated | 55 | ---------/authenticated |
| 56 | ------------index.html | 56 | ------------index.html |
| 57 | ---------/public | 57 | ---------/public |
| 58 | ------------login.html | 58 | ------------login.html |
| 59 | ------------not-found.html | 59 | ------------not-found.html |
| 60 | ------------recover-password.html | 60 | ------------recover-password.html |
| 61 | ------------reset-password.html | 61 | ------------reset-password.html |
| 62 | ------------signup.html | 62 | ------------signup.html |
| 63 | ---/collections | 63 | ---/collections |
| 64 | ------example.coffee | 64 | ------example.coffee |
| 65 | ---/lib | 65 | ---/lib |
| 66 | ---/packages | 66 | ---/packages |
| 67 | ------ (See List Above) | 67 | ------ (See List Above) |
| 68 | ---/public | 68 | ---/public |
| 69 | ---/server | 69 | ---/server |
| 70 | ------/admin | 70 | ------/admin |
| 71 | ---------accounts.coffee | 71 | ---------accounts.coffee |
| 72 | ---------startup.coffee | 72 | ---------startup.coffee |
| 73 | ------/data | 73 | ------/data |
| 74 | ---------/insert | 74 | ---------/insert |
| 75 | ---------/update | 75 | ---------/update |
| 76 | ---------/remove | 76 | ---------/remove |
| 77 | 77 | ||
| 78 | ---------/send | 78 | ---------/send |
| 79 | ---------/templates | 79 | ---------/templates |
| 80 | ------------reset-password.coffee | ||
| 80 | ------/publications | 81 | ------/publications |
| 81 | ``` | 82 | ``` |
| 82 | 83 | ||
| 83 | ### Language & Formatting | 84 | ### Language & Formatting |
| 84 | There are two considerations when using Base: JavaScript is written in [CoffeeScript](http://coffeescript.org) and CSS is written using [Sass](http://sass-lang.com). I prefer this setup because it allows me to move a little quicker than I do when writing in the native languages. This may not be for everybody, but I recommend giving both a shot because they make it much easier to write code. | 85 | There are two considerations when using Base: JavaScript is written in [CoffeeScript](http://coffeescript.org) and CSS is written using [Sass](http://sass-lang.com). I prefer this setup because it allows me to move a little quicker than I do when writing in the native languages. This may not be for everybody, but I recommend giving both a shot because they make it much easier to write code. |
| 85 | 86 | ||
| 86 | ### Functionality | 87 | ### Functionality |
| 87 | 88 | ||
| 88 | ###### Bootstrap (@3.2.0) | 89 | ###### Bootstrap (@3.2.0) |
| 89 | Base makes use of the [Bootstrap](http://getbootstrap.com) Front-End Framework. It may not be your bag of chips and is *definitely not required*. If you want to swap it out, you'll need to unhook the markup in each of the included template files in `/client/views` and uninstall the Bootstrap3 package by running `meteor remove pinglamb:bootstrap3` in your terminal. | 90 | Base makes use of the [Bootstrap](http://getbootstrap.com) Front-End Framework. It may not be your bag of chips and is *definitely not required*. If you want to swap it out, you'll need to unhook the markup in each of the included template files in `/client/views` and uninstall the Bootstrap3 package by running `meteor remove pinglamb:bootstrap3` in your terminal. |
| 90 | 91 | ||
| 91 | ###### Basic Routing | 92 | ###### Basic Routing |
| 92 | A collection of pre-defined routes and templates for common functionality (see Authenticate below). Also includes a set of common route filters for managing user access. Routes bundled include: | 93 | A collection of pre-defined routes and templates for common functionality (see Authenticate below). Also includes a set of common route filters for managing user access. Routes bundled include: |
| 93 | 94 | ||
| 94 | ``` | 95 | ``` |
| 95 | - / (Authenticated) | 96 | - / (Authenticated) |
| 96 | - /login (Public) | 97 | - /login (Public) |
| 97 | - /signup (Public) | 98 | - /signup (Public) |
| 98 | - /recover-password (Public) | 99 | - /recover-password (Public) |
| 99 | - /reset-password (Public) | 100 | - /reset-password (Public) |
| 100 | ``` | 101 | ``` |
| 101 | 102 | ||
| 102 | ###### Authentication (Not Included Yet, Just Documenting) | 103 | ###### Authentication |
| 103 | A complete authentication pattern complete with: | 104 | A complete authentication pattern complete with: |
| 104 | 105 | ||
| 105 | - Signup (at /signup) | 106 | - Signup (at /signup) |
| 106 | - Login (at /login) | 107 | - Login (at /login) |
| 107 | - Password Recovery (at /recover-password and /reset-password) | 108 | - Password Recovery (at /recover-password and /reset-password) |
| 108 | 109 | ||
| 110 | ###### Validation (Not Added Yet) | ||
| 111 | Validation via [jQuery Validation](http://jqueryvalidation.org). This applies to all of the public templates: login, signup, recover password, and reset password. | ||
| 112 | |||
| 109 | ###### Automatic Admin User Creation | 113 | ###### Automatic Admin User Creation |
| 110 | When developing, having a handful of user accounts to test your application with can come in handy. Base comes with an automated account generation script located in `server/admin/startup.coffee` that creates accounts based on an array of specified users. **Note: by default this creates one Admin user on server startup, so make sure to customize or remove this user so the public can't access your app**. | 114 | When developing, having a handful of user accounts to test your application with can come in handy. Base comes with an automated account generation script located in `server/admin/startup.coffee` that creates accounts based on an array of specified users. **Note: by default this creates one Admin user on server startup, so make sure to customize or remove this user so the public can't access your app**. |
| 111 | 115 |