Commit aa1738cc4866c9081dd1a8e0b5c3630b038afdfb
1 parent
69cb85cfe8
Exists in
master
Bump Meteor to 1.0.3.2.
Update README to reflect bump to 1.0.3.2. Bump themeteorchef:bert to 1.0.2. Bump twbs:bootstrap to 3.3.2. Closes #38.
Showing
3 changed files
with
4 additions
and
4 deletions
Show diff stats
.meteor/release
1 | METEOR@1.0.3.1 | 1 | METEOR@1.0.3.2 |
2 | 2 |
.meteor/versions
1 | accounts-base@1.1.3 | 1 | accounts-base@1.1.3 |
2 | accounts-password@1.0.6 | 2 | accounts-password@1.0.6 |
3 | application-configuration@1.0.4 | 3 | application-configuration@1.0.4 |
4 | audit-argument-checks@1.0.2 | 4 | audit-argument-checks@1.0.2 |
5 | autoupdate@1.1.5 | 5 | autoupdate@1.1.5 |
6 | base64@1.0.2 | 6 | base64@1.0.2 |
7 | binary-heap@1.0.2 | 7 | binary-heap@1.0.2 |
8 | blaze@2.0.4 | 8 | blaze@2.0.4 |
9 | blaze-tools@1.0.2 | 9 | blaze-tools@1.0.2 |
10 | boilerplate-generator@1.0.2 | 10 | boilerplate-generator@1.0.2 |
11 | browser-policy@1.0.3 | 11 | browser-policy@1.0.3 |
12 | browser-policy-common@1.0.2 | 12 | browser-policy-common@1.0.2 |
13 | browser-policy-content@1.0.3 | 13 | browser-policy-content@1.0.3 |
14 | browser-policy-framing@1.0.3 | 14 | browser-policy-framing@1.0.3 |
15 | callback-hook@1.0.2 | 15 | callback-hook@1.0.2 |
16 | check@1.0.4 | 16 | check@1.0.4 |
17 | cmather:handlebars-server@2.0.0 | 17 | cmather:handlebars-server@2.0.0 |
18 | ddp@1.0.14 | 18 | ddp@1.0.14 |
19 | deps@1.0.6 | 19 | deps@1.0.6 |
20 | ejson@1.0.5 | 20 | ejson@1.0.5 |
21 | email@1.0.5 | 21 | email@1.0.5 |
22 | fastclick@1.0.2 | 22 | fastclick@1.0.2 |
23 | follower-livedata@1.0.3 | 23 | follower-livedata@1.0.3 |
24 | geojson-utils@1.0.2 | 24 | geojson-utils@1.0.2 |
25 | handlebars@1.0.2 | 25 | handlebars@1.0.2 |
26 | html-tools@1.0.3 | 26 | html-tools@1.0.3 |
27 | htmljs@1.0.3 | 27 | htmljs@1.0.3 |
28 | http@1.0.10 | 28 | http@1.0.10 |
29 | id-map@1.0.2 | 29 | id-map@1.0.2 |
30 | iron:controller@1.0.7 | 30 | iron:controller@1.0.7 |
31 | iron:core@1.0.7 | 31 | iron:core@1.0.7 |
32 | iron:dynamic-template@1.0.7 | 32 | iron:dynamic-template@1.0.7 |
33 | iron:layout@1.0.7 | 33 | iron:layout@1.0.7 |
34 | iron:location@1.0.7 | 34 | iron:location@1.0.7 |
35 | iron:middleware-stack@1.0.7 | 35 | iron:middleware-stack@1.0.7 |
36 | iron:router@1.0.7 | 36 | iron:router@1.0.7 |
37 | iron:url@1.0.7 | 37 | iron:url@1.0.7 |
38 | jquery@1.11.3 | 38 | jquery@1.11.3 |
39 | json@1.0.2 | 39 | json@1.0.2 |
40 | launch-screen@1.0.1 | 40 | launch-screen@1.0.1 |
41 | livedata@1.0.12 | 41 | livedata@1.0.12 |
42 | localstorage@1.0.2 | 42 | localstorage@1.0.2 |
43 | logging@1.0.6 | 43 | logging@1.0.6 |
44 | meteor@1.1.4 | 44 | meteor@1.1.4 |
45 | meteor-platform@1.2.1 | 45 | meteor-platform@1.2.1 |
46 | meteorhacks:async@1.0.0 | 46 | meteorhacks:async@1.0.0 |
47 | meteorhacks:npm@1.2.2 | 47 | meteorhacks:npm@1.2.2 |
48 | minifiers@1.1.3 | 48 | minifiers@1.1.3 |
49 | minimongo@1.0.6 | 49 | minimongo@1.0.6 |
50 | mobile-status-bar@1.0.2 | 50 | mobile-status-bar@1.0.2 |
51 | mongo@1.0.11 | 51 | mongo@1.0.11 |
52 | npm-bcrypt@0.7.7 | 52 | npm-bcrypt@0.7.7 |
53 | npm-container@1.0.0 | 53 | npm-container@1.0.0 |
54 | observe-sequence@1.0.4 | 54 | observe-sequence@1.0.4 |
55 | ordered-dict@1.0.2 | 55 | ordered-dict@1.0.2 |
56 | particle4dev:sass@0.3.0 | 56 | particle4dev:sass@0.3.0 |
57 | random@1.0.2 | 57 | random@1.0.2 |
58 | reactive-dict@1.0.5 | 58 | reactive-dict@1.0.5 |
59 | reactive-var@1.0.4 | 59 | reactive-var@1.0.4 |
60 | reload@1.1.2 | 60 | reload@1.1.2 |
61 | retry@1.0.2 | 61 | retry@1.0.2 |
62 | routepolicy@1.0.4 | 62 | routepolicy@1.0.4 |
63 | service-configuration@1.0.3 | 63 | service-configuration@1.0.3 |
64 | session@1.0.5 | 64 | session@1.0.5 |
65 | sha@1.0.2 | 65 | sha@1.0.2 |
66 | spacebars@1.0.5 | 66 | spacebars@1.0.5 |
67 | spacebars-compiler@1.0.4 | 67 | spacebars-compiler@1.0.4 |
68 | srp@1.0.2 | 68 | srp@1.0.2 |
69 | standard-app-packages@1.0.4 | 69 | standard-app-packages@1.0.4 |
70 | templating@1.0.11 | 70 | templating@1.0.11 |
71 | themeteorchef:bert@1.0.1 | 71 | themeteorchef:bert@1.0.2 |
72 | themeteorchef:jquery-validation@1.13.1 | 72 | themeteorchef:jquery-validation@1.13.1 |
73 | tracker@1.0.5 | 73 | tracker@1.0.5 |
74 | twbs:bootstrap@3.3.1_2 | 74 | twbs:bootstrap@3.3.2 |
75 | ui@1.0.5 | 75 | ui@1.0.5 |
76 | underscore@1.0.2 | 76 | underscore@1.0.2 |
77 | url@1.0.3 | 77 | url@1.0.3 |
78 | webapp@1.1.6 | 78 | webapp@1.1.6 |
79 | webapp-hashing@1.0.2 | 79 | webapp-hashing@1.0.2 |
80 | 80 |
README.md
1 | # The Meteor Chef - Base (@1.0.3.1) | 1 | # The Meteor Chef - Base (@1.0.3.2) |
2 | A starting point for Meteor apps. | 2 | A starting point for Meteor apps. |
3 | 3 | ||
4 | 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. | 4 | 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. |
5 | 5 | ||
6 | For more detail on updates, [read the Changelog](https://github.com/themeteorchef/base/wiki/Changelog). If you're interested in contributing to Base, checkout the [Contribution wiki](https://github.com/themeteorchef/base/wiki/Contributing-to-Base) to get started. | 6 | For more detail on updates, [read the Changelog](https://github.com/themeteorchef/base/wiki/Changelog). If you're interested in contributing to Base, checkout the [Contribution wiki](https://github.com/themeteorchef/base/wiki/Contributing-to-Base) to get started. |
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 | - Bert - `meteor add themeteorchef:bert` | 12 | - Bert - `meteor add themeteorchef:bert` |
13 | - Bootstrap 3 - `meteor add twbs:bootstrap` | 13 | - Bootstrap 3 - `meteor add twbs:bootstrap` |
14 | - Browser Policy - `meteor add browser-policy` | 14 | - Browser Policy - `meteor add browser-policy` |
15 | - Check - `meteor add check` | 15 | - Check - `meteor add check` |
16 | - Handlebars Server - `meteor add cmather:handlebars-server` | 16 | - Handlebars Server - `meteor add cmather:handlebars-server` |
17 | - Iron Router - `meteor add iron:router` | 17 | - Iron Router - `meteor add iron:router` |
18 | - jQuery - `meteor add jquery` | 18 | - jQuery - `meteor add jquery` |
19 | - jQuery Validation - `meteor add themeteorchef:jquery-validation` | 19 | - jQuery Validation - `meteor add themeteorchef:jquery-validation` |
20 | - NPM - `meteor add meteorhacks:npm` | 20 | - NPM - `meteor add meteorhacks:npm` |
21 | - Sass - `meteor add particle4dev:sass@0.3.0` | 21 | - Sass - `meteor add particle4dev:sass@0.3.0` |
22 | - Underscore - `meteor add underscore` | 22 | - Underscore - `meteor add underscore` |
23 | 23 | ||
24 | **Note:** Base also supports loading NPM packages using the `meteorhacks:npm` package. To load NPM packages, add name and version information to `/packages.json` and inside of your file (server only), load the package with `var package = Meteor.npmRequire('package-name');`. For more information, see the [meteorhacks:npm documentation](https://github.com/meteorhacks/npm/). | 24 | **Note:** Base also supports loading NPM packages using the `meteorhacks:npm` package. To load NPM packages, add name and version information to `/packages.json` and inside of your file (server only), load the package with `var package = Meteor.npmRequire('package-name');`. For more information, see the [meteorhacks:npm documentation](https://github.com/meteorhacks/npm/). |
25 | 25 | ||
26 | ### File Structure | 26 | ### File Structure |
27 | 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: | 27 | 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: |
28 | 28 | ||
29 | ``` | 29 | ``` |
30 | /root | 30 | /root |
31 | ---/.meteor | 31 | ---/.meteor |
32 | ---/client | 32 | ---/client |
33 | ------/controllers | 33 | ------/controllers |
34 | ---------/authenticated | 34 | ---------/authenticated |
35 | ------------header.js | 35 | ------------header.js |
36 | ---------/public | 36 | ---------/public |
37 | ------------login.js | 37 | ------------login.js |
38 | ------------recover-password.js | 38 | ------------recover-password.js |
39 | ------------reset-password.js | 39 | ------------reset-password.js |
40 | ------------signup.js | 40 | ------------signup.js |
41 | ------/helpers | 41 | ------/helpers |
42 | ---------helpers-ui.js | 42 | ---------helpers-ui.js |
43 | ------/includes | 43 | ------/includes |
44 | ---------_header.html | 44 | ---------_header.html |
45 | ------/layouts | 45 | ------/layouts |
46 | ---------layout-default.html | 46 | ---------layout-default.html |
47 | ------/routes | 47 | ------/routes |
48 | ---------hooks.js | 48 | ---------hooks.js |
49 | ---------routes-authenticated.js | 49 | ---------routes-authenticated.js |
50 | ---------routes-global.js | 50 | ---------routes-global.js |
51 | ---------routes-public.js | 51 | ---------routes-public.js |
52 | ------/stylesheets | 52 | ------/stylesheets |
53 | ---------/sass | 53 | ---------/sass |
54 | ------------/globals | 54 | ------------/globals |
55 | ---------------_extends.scss | 55 | ---------------_extends.scss |
56 | ------------/views | 56 | ------------/views |
57 | ---------------/public | 57 | ---------------/public |
58 | ------------------_login.scss | 58 | ------------------_login.scss |
59 | ---------application.scss | 59 | ---------application.scss |
60 | -------/views | 60 | -------/views |
61 | ---------/authenticated | 61 | ---------/authenticated |
62 | ------------index.html | 62 | ------------index.html |
63 | ---------/public | 63 | ---------/public |
64 | ------------loading.html | 64 | ------------loading.html |
65 | ------------login.html | 65 | ------------login.html |
66 | ------------not-found.html | 66 | ------------not-found.html |
67 | ------------recover-password.html | 67 | ------------recover-password.html |
68 | ------------reset-password.html | 68 | ------------reset-password.html |
69 | ------------signup.html | 69 | ------------signup.html |
70 | ---/collections | 70 | ---/collections |
71 | ------example.js | 71 | ------example.js |
72 | ------users.js | 72 | ------users.js |
73 | ---/packages | 73 | ---/packages |
74 | ------ (See List Above) | 74 | ------ (See List Above) |
75 | ---/public | 75 | ---/public |
76 | ---/server | 76 | ---/server |
77 | ------/admin | 77 | ------/admin |
78 | ---------/startup-functions | 78 | ---------/startup-functions |
79 | ------------browser-policies.js | 79 | ------------browser-policies.js |
80 | ------------test-accounts.js | 80 | ------------test-accounts.js |
81 | ---------startup.js | 81 | ---------startup.js |
82 | 82 | ||
83 | ---------/templates | 83 | ---------/templates |
84 | ------------reset-password.js | 84 | ------------reset-password.js |
85 | ------/publications | 85 | ------/publications |
86 | ---------example.js | 86 | ---------example.js |
87 | ``` | 87 | ``` |
88 | 88 | ||
89 | ### JavaScript & CSS | 89 | ### JavaScript & CSS |
90 | Prior to v2.0.0, Base was written in CoffeeScript. At the request of the community, Base was ported _back_ to native JavaScript. | 90 | Prior to v2.0.0, Base was written in CoffeeScript. At the request of the community, Base was ported _back_ to native JavaScript. |
91 | 91 | ||
92 | CSS in Base is written using [Sass](http://sass-lang.com). | 92 | CSS in Base is written using [Sass](http://sass-lang.com). |
93 | 93 | ||
94 | ### Functionality | 94 | ### Functionality |
95 | 95 | ||
96 | ###### Configuration | 96 | ###### Configuration |
97 | For things like API keys and connection strings, Base supports loading a `settings.json` file (located at `/settings.json`) on startup. By default, `settings.json` includes a `public` and `private` object where you can store client only and server only values respectively. | 97 | For things like API keys and connection strings, Base supports loading a `settings.json` file (located at `/settings.json`) on startup. By default, `settings.json` includes a `public` and `private` object where you can store client only and server only values respectively. |
98 | 98 | ||
99 | When starting Meteor, **make sure to use the --settings flag**, passing the location of your settings.json file to Meteor, e.g. `meteor --settings settings.json`. This is required in order for `settings.json` to work properly. | 99 | When starting Meteor, **make sure to use the --settings flag**, passing the location of your settings.json file to Meteor, e.g. `meteor --settings settings.json`. This is required in order for `settings.json` to work properly. |
100 | 100 | ||
101 | To learn more about making use of `settings.json`, check out [our example in the Meteor Patterns wiki](https://github.com/themeteorchef/base/wiki/Meteor-Patterns#9-configuration). | 101 | To learn more about making use of `settings.json`, check out [our example in the Meteor Patterns wiki](https://github.com/themeteorchef/base/wiki/Meteor-Patterns#9-configuration). |
102 | 102 | ||
103 | ###### Bootstrap (@3.2.1) | 103 | ###### Bootstrap (@3.2.1) |
104 | 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 `twbs:bootstrap` package by running `meteor remove twbs:bootstrap` in your terminal. | 104 | 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 `twbs:bootstrap` package by running `meteor remove twbs:bootstrap` in your terminal. |
105 | 105 | ||
106 | In respect to UI, Base uses Bootstrap's `.navbar` element, as well as its `.container` and a few `.row`/`.col-<size>-<columns>` wrappers. You'll also find the `.btn` class and its modifiers (`.success, .warning, etc.`) in use throughout the app. All of these implementations are merely presentational and can be changed (or removed) as you see fit. | 106 | In respect to UI, Base uses Bootstrap's `.navbar` element, as well as its `.container` and a few `.row`/`.col-<size>-<columns>` wrappers. You'll also find the `.btn` class and its modifiers (`.success, .warning, etc.`) in use throughout the app. All of these implementations are merely presentational and can be changed (or removed) as you see fit. |
107 | 107 | ||
108 | ###### Basic Routing | 108 | ###### Basic Routing |
109 | Base comes with a collection of pre-defined routes and templates for common functionality. Base also includes a set of common route filters for managing user access. Routes bundled include: | 109 | Base comes with a collection of pre-defined routes and templates for common functionality. Base also includes a set of common route filters for managing user access. Routes bundled include: |
110 | 110 | ||
111 | ``` | 111 | ``` |
112 | - / (Authenticated) | 112 | - / (Authenticated) |
113 | - /login (Public) | 113 | - /login (Public) |
114 | - /recover-password (Public) | 114 | - /recover-password (Public) |
115 | - /reset-password (Public) | 115 | - /reset-password (Public) |
116 | - /signup (Public) | 116 | - /signup (Public) |
117 | ``` | 117 | ``` |
118 | 118 | ||
119 | A UI helper called `currentRoute` has been added to Base which allows you to add an `active` class to menu items in your navigation to reflect the user's current location. | 119 | A UI helper called `currentRoute` has been added to Base which allows you to add an `active` class to menu items in your navigation to reflect the user's current location. |
120 | 120 | ||
121 | A collection of hooks has also been added to Base to control route access based on different conditions (e.g. whether a user is logged in or not). | 121 | A collection of hooks has also been added to Base to control route access based on different conditions (e.g. whether a user is logged in or not). |
122 | 122 | ||
123 | ###### Authentication | 123 | ###### Authentication |
124 | Base includes a complete authentication pattern complete with: | 124 | Base includes a complete authentication pattern complete with: |
125 | 125 | ||
126 | - Login (at /login) | 126 | - Login (at /login) |
127 | - Logout (no path, implemented as a dropdown item/click event in /client/controllers/header.js) | 127 | - Logout (no path, implemented as a dropdown item/click event in /client/controllers/header.js) |
128 | - Password Recovery (at /recover-password and /reset-password) | 128 | - Password Recovery (at /recover-password and /reset-password) |
129 | - Signup (at /signup) | 129 | - Signup (at /signup) |
130 | 130 | ||
131 | ###### Example Collection/Publication/Subscription | 131 | ###### Example Collection/Publication/Subscription |
132 | Base includes a collection called `Example`, along with a publication and subscription pattern to show moving data from the server to the client. Publications are defined in `/server/publications/example.js` and a subscription is demonstrated on the `index` route in `/client/routes/routes-authenticated.js`. | 132 | Base includes a collection called `Example`, along with a publication and subscription pattern to show moving data from the server to the client. Publications are defined in `/server/publications/example.js` and a subscription is demonstrated on the `index` route in `/client/routes/routes-authenticated.js`. |
133 | 133 | ||
134 | ###### Validation | 134 | ###### Validation |
135 | Base includes support for client-side validation via [jQuery Validation](http://jqueryvalidation.org). Validation is provided for all public templates: login, signup, recover password, and reset password. | 135 | Base includes support for client-side validation via [jQuery Validation](http://jqueryvalidation.org). Validation is provided for all public templates: login, signup, recover password, and reset password. |
136 | 136 | ||
137 | ###### Alerts | 137 | ###### Alerts |
138 | Base includes support for fixed bar (top and bottom) and growl-style alerts on the client via [`themeteorchef:bert`](https://atmospherejs.com/themeteorchef/bert). | 138 | Base includes support for fixed bar (top and bottom) and growl-style alerts on the client via [`themeteorchef:bert`](https://atmospherejs.com/themeteorchef/bert). |
139 | 139 | ||
140 | ###### Automatic Admin User Creation | 140 | ###### Automatic Admin User Creation |
141 | 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.js` 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**. | 141 | 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.js` 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**. |
142 | 142 |