p5.js-web-editor/README.md

63 lines
3.3 KiB
Markdown
Raw Normal View History

2016-05-11 06:02:12 +02:00
#p5.js Web Editor
2016-05-03 22:13:04 +02:00
2016-05-11 06:02:12 +02:00
This project is currently in the early stages of development! It will definitely be announced when it is in alpha/beta/etc.
2016-06-29 00:21:05 +02:00
##Development Installation
2016-05-11 06:02:12 +02:00
2016-06-29 00:21:05 +02:00
1. Clone this repostory and cd into it
2. `$ npm install`
3. Install MongoDB and make sure it is running
4. Create a file called `.env` in the root of this directory that looks like
```bash
MONGO_URL=mongodb://localhost:27017/p5js-web-editor
PORT=8000
SESSION_SECRET=whatever_you_want_this_to_be_it_only_matters_for_production
AWS_ACCESS_KEY=<your-aws-access-key>
AWS_SECRET_KEY=<your-aws-secret-key>
S3_BUCKET=<your-s3-bucket>
2016-06-29 00:21:05 +02:00
```
Or, if you don't want to do that, just ask me to send you mine. Refer to this gist for creating an S3 bucket for testing, or if you don't want to do that, I will send you my AWS credentials.
2016-06-29 00:21:05 +02:00
5. `$ npm start`
2016-06-29 00:28:35 +02:00
6. Navigate to (http://localhost:8000)[http://localhost:8000] in your browser
2016-06-29 00:21:05 +02:00
7. Install the [React Developer Tools](https://chrome.google.com/webstore/detail/react-developer-tools/fmkadmapgofadopljbjfkapdkoienihi?hl=en).
8. Open and close the Redux DevTools using `ctrl+h`, and move them with `ctrl+w`
2016-05-11 06:02:12 +02:00
2016-06-29 00:21:05 +02:00
##Production Installation
2016-06-29 00:28:35 +02:00
1. Clone this repostory and `cd` into it
2016-06-29 00:21:05 +02:00
2. `$ npm install`
3. Install MongoDB and make sure it is running
4. Create a file called `.env` in the root of this directory that looks like
```bash
MONGO_URL=mongodb://localhost:27017/p5js-web-editor
PORT=8000
SESSION_SECRET=make_this_a_long-random_string_like_maybe_126_characters_long
AWS_ACCESS_KEY=<your-aws-access-key>
AWS_SECRET_KEY=<your-aws-secret-key>
S3_BUCKET=<your-s3-bucket>
2016-06-29 00:21:05 +02:00
```
Or, if you don't want to do that, just ask me to send you mine.
5. `$ npm run build`
6. `$ npm run start:prod`
2016-05-11 06:02:12 +02:00
2016-06-29 00:28:35 +02:00
###For Production Setup with PM2
2016-06-29 00:21:05 +02:00
1. `$ npm install -g pm2`
2. `$ pm2 start ecosystem.json`
##Contribution Guide
I am currently open to contributors! Email me if you are looking for a task, or look at the open issues and reply that you are working on a task.
The p5.js Web Editor is built on a MERN stack - MongoDB, Express, React/Redux, and Node. For a reference to the file structure format I am using, please look at the [Mern Starter](https://github.com/Hashnode/mern-starter) and [this comment](https://github.com/Hashnode/mern-starter/issues/90#issuecomment-221553573).
This project does not use CSS Modules, but uses Sass. I like to follow [BEM rules](http://getbem.com/) for CSS naming conventions, write OOSCSS with placeholders and mixins, and follow the [7-1 Pattern](https://sass-guidelin.es/#the-7-1-pattern) for Sass.
I'm new to using ESLint, but I decided on a configuration based on some popular React/Redux boilerplates. Open to suggestions on this. If in development, you're getting annoyed with ESLint, you can remove it from `webpack.config.dev.js` in the JavaScript loader, or disable any line from eslint by commenting at the end of the line `// eslint-disable-line`.
2016-05-11 06:02:12 +02:00
##Dump of links I'm saving for reference
2016-06-29 18:52:16 +02:00
* https://github.com/brigade/scss-lint
2016-05-03 22:13:04 +02:00
* https://github.com/petehunt/react-howto
* https://github.com/jsbin/jsbin (especially look at the console)
2016-05-11 06:02:12 +02:00
* Need to figure out how to solve the XSS issue, https://github.com/jsbin/jsbin/wiki/Best-practices-for-building-your-own-live-paste-bin
2016-06-09 19:56:23 +02:00
* https://www.npmjs.com/package/express-subdomain
2016-06-15 02:29:37 +02:00
* https://github.com/jsbin/jsbin/blob/master/public/js/render/console.js - the code is a little messy but it might be our only hope for a console