bbokorney / hold-my-beer

A sample application for AWS CloudSearch.

Hold My Beer

Hold My Beer is a sample application for AWS CloudSearch. It's a static web app for querying a dataset of beers.

AWS Setup

CloudSearch

0. Go to the CloudSearch Dashboard.
1. Click Create a Domain.
2. Give it a name (e.g. hold-my-beer).
3. In the Access Policies, set policy to "Search and Suggester service: Allow all. Document Service: Account owner only."
4. Wait until access policies are done processing.

Suggester

0. Suggesters > Add Suggester
1. Give it a name. Set "Source Field" to "name", and "Fuzzy Matching" to "high".
2. Re-index your domain. This can take a while.

API Gateway

0. Create a resource for /search.
1. Create a GET for /search.
2. Select the integration type HTTP.
3. Specify the Endpoint URL as https://.us-east-1.cloudsearch.amazonaws.com/2013-01-01/search
4. Method Request > URL Query String Parameters add q, q.parser, q.options.
5. Actions > Deploy API
6. Create new stage, give it a name.
7. Click Deploy

Running the app

Export the url of your API gateway domain.

export REACT_APP_SEARCH_URL='https://abc123defg.execute-api.us-east-1.amazonaws.com/stage-name'

Install dependencies and start the project.

npm install
npm start

Credits

Beer stein favicon from freefavicon.com.