# p5.js Web Editor This project is currently in development! It will be announced when there is a (public) beta release. ## Development Installation 1. Fork this repository. 2. Clone the forked repository and cd into it 3. `$ npm install` 4. Install MongoDB and make sure it is running * For Mac OSX with [homebrew](http://brew.sh/): `brew install mongodb` then `brew services start mongodb` * For Windows and Linux: [MongoDB Installation](https://docs.mongodb.com/manual/installation/) 5. Create a file called `.env` in the root of this directory that looks like ``` API_URL=/api 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= AWS_SECRET_KEY= AWS_REGION= S3_BUCKET= GITHUB_ID= GITHUB_SECRET= GOOGLE_ID= (use google+ api) GOOGLE_SECRET= (use google+ api) MAILGUN_KEY= EXAMPLE_USER_EMAIL= EXAMPLE_USER_PASSWORD= ``` If you don't care about being able to upload media files to S3 or Login with Github or Google, you can drop in the file exactly how it is. Or, if you don't want to do that, just ask me to send you mine. Refer to [this gist](https://gist.github.com/catarak/70c9301f0fd1ac2d6b58de03f61997e3) for creating an S3 bucket for testing, or if you don't want to do that, I can add you to one of my S3 buckets. 6. `$ npm run fetch-examples` - this downloads the example sketches into a user called 'p5' 7. `$ npm start` 8. Navigate to [http://localhost:8000](http://localhost:8000) in your browser 9. Install the [React Developer Tools](https://chrome.google.com/webstore/detail/react-developer-tools/fmkadmapgofadopljbjfkapdkoienihi?hl=en). 10. Open and close the Redux DevTools using `ctrl+h`, and move them with `ctrl+w` ### Testing SSL on your local machine Please refer to [this gist](https://gist.github.com/andrewn/953ffd5cb17ac2634dc969fc7bdaff3f). This allows you to access the editor using both HTTP and HTTPS. Don't worry about this unless you need to make changes or test HTTPS behavior. The automatic redirection to HTTPS is turned off by default in development. If you need to test this behavior, put `FORCE_TO_HTTPS=true` in your `.env` file. ## Development Installation using Docker Using Docker, you can have a complete, consistent development environment without having to manually install dependencies such as Node, Mongo, etc. It also helps isolate these dependencies and their data from other projects that you may have on the same computer that use different/conflicting versions, etc. Note that this takes up a significant amount of space on your machine. Make sure you have at least 5GB free. 1. Install Docker for your operating system * Mac: https://www.docker.com/docker-mac * Windows: https://www.docker.com/docker-windows 2. Clone this repository and cd into it 3. `$ docker-compose -f docker-compose-development.yml build` 4. `$ docker-compose -f docker-compose-development.yml run --rm server npm run fetch-examples` Now, anytime you wish to start the server with its dependencies, you can run: 5. `$ docker-compose -f docker-compose-development.yml up` 6. Navigate to [http://localhost:8000](http://localhost:8000) in your browser To open a terminal/shell in the running Docker server (i.e. after `docker-compose up` has been run): 7. `$ docker-compose -f docker-compose-development.yml exec server bash -l` If you don't have the full server environment running, you can launch a one-off container instance (and have it automatically deleted after you're done using it): 8. `$ docker-compose -f docker-compose-development.yml run server --rm bash -l` ## Production Installation 1. Clone this repository 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 ``` API_URL=/api 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= AWS_SECRET_KEY= AWS_REGION= S3_BUCKET= GITHUB_ID= GITHUB_SECRET= GOOGLE_ID= (use google+ api) GOOGLE_SECRET= (use google+ api) EMAIL_SENDER= MAILGUN_KEY= MAILGUN_DOMAIN= EMAIL_VERIFY_SECRET_TOKEN=whatever_you_want_this_to_be_it_only_matters_for_production EXAMPLE_USER_EMAIL= EXAMPLE_USER_PASSWORD= ``` For production, you will need to have real Github and Amazon credentials. Refer to [this gist](https://gist.github.com/catarak/70c9301f0fd1ac2d6b58de03f61997e3) for creating an S3 bucket for testing. 5. `$ npm run fetch-examples` - this downloads the example sketches into a user called 'p5' 6. `$ npm run build` 7. `$ npm run start:prod` ### For Production Setup with PM2 1. `$ npm install -g pm2` 2. `$ pm2 start ecosystem.json` ## Optional S3 bucket URL base configuration If your S3 bucket is in the US East (N Virginia) region (us-east-1), you'll need to set a custom URL base for it, because it does not follow the standard naming pattern as the rest of the regions. Instead, add the following to your environment/.env file: ```S3_BUCKET_URL_BASE=https://s3.amazonaws.com``` If you've configured your S3 bucket and DNS records to use a custom domain name, you can also set it using this variable. I.e.: ```S3_BUCKET_URL_BASE=https://files.mydomain.com``` For more information on using a custom domain, see this documentation link: http://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html#VirtualHostingCustomURLs ## Accessibility Guidelines Here is guide on [how to use the accessible editor](https://gist.github.com/MathuraMG/e86666b7b41fbc8c078bad9aff3f666d) and here is an overview of the [p5-accessibility.js](https://github.com/processing/p5.accessibility) library that makes p5.js sketches accessible to screen readers. The code for the p5.js web editor adheres to web accessibility standards. The following guidelines will help to ensure that accessibility continues to be a priority as development continues. **Code Structure** * Screen Readers are an assistive technology for vision loss which helps users to navigate a web page. They are able to prioritize content based on the semantic meaning of HTML tags. Therefore, it is important to use specific tags, such as `nav`, `ul`, `li`, `section`, and so on. `div` is the least screen reader friendly tag. For example, [here is the semantic meaning of the `body` tag](http://html5doctor.com/element-index/#body) * All buttons/links/windows need to be accessible by the keyboard ( By tabbing, pressing space etc.) * In cases where tags are not screen reader friendly, we can take advantage of [tabIndex](http://webaim.org/techniques/keyboard/tabindex). Using tabIndex ensures that all elements are accessible via keyboard. [code example](https://github.com/processing/p5.js-web-editor/blob/master/client/modules/IDE/components/Editor.jsx#L249) * When opening a new window or pop up window, ensure the keyboard focus also moves to the new window. [code example](https://github.com/processing/p5.js-web-editor/blob/master/client/modules/IDE/components/NewFileForm.jsx#L16) **Labeling** * When creating button icons, images, or something without text (this does not include an HTML5 `