This project is a contact form built with React. It sends emails with EmailJS instead of needing a back end. EmailJS is a third-party service that allows you to send up to 200 emails per month for free.

First go to https://dashboard.emailjs.com/sign-up and create a free account.

Once your account is created, click on the Email Services link on the navigation menu and choose which service you would like to use.

Then go to the Email Templates link and click Create New Template. Update the template to contain the information and styling you would like to receive in your emails. The items in double curly brackets ({{}}) should match the variables from your React app code (e.g., {{name}}, {{email}}, {{message}}).

Make sure that the To Email is set to the address where you would like to receive your emails. It should be the same address that you used when you selected and configured the email service. When done modifying the template, click on Save.

Clone or fork the repo, then use the terminal to navigate to the folder that was created and type:

npm i

This will install the modules necessary for the app to function properly.

You will also need to create a .env file in the project root and add the following code, and add .env to the .gitignore file:

REACT_APP_SERVICE_ID='add your emailjs service id'
REACT_APP_TEMPLATE_ID='add your emailjs template id'
REACT_APP_PUBLIC_KEY='add your emailjs public key'

Replace the text in quotes with your ids. These ids can be found on the EmailJS website. The service id is shown on the Email Services page, the template id is shown on the Email Templates page, and the public key in on the Account page which you access by clicking on your name in the top right corner.

Using the terminal type:

npm start

This will launch the app and open a new browser tab.

You can then test it by filling out the form and submitting it.

Email: [email protected]

Copyright (c) 2021 Todd Harvey

Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.

THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.