This is the repository for the my cactus simulation Alexa Game. This is an Alexa skill where players manage the light and watering of a cactus. They must check in frequently and keep the cactus alive and happy!
This skill uses the Alexa Web API for Games for 3D graphics on capable devices. The game is fully playable everywhere Alexa is, since it is a voice-driven experience.
If you're interested in the design of the skill check out the design assets folder. There you'll find the storyboard that our VUI designer used to map out all the scenarios and a template for you to build your own storyboards using Adobe XD.
We are streaming about this skill on the AmazonAlexa Twitch channel Wednesday & Friday @ 10AM PT. You can view prior episodes on demand on twitch.
This project is meant to be used with ASK CLI V2. There is AWS infrastructure involved and you will also need an AWS account for this. This uses the ASK CLI V2 cfn-deployer. The infrastructure is defined in skill-stack.yaml. The code is defined in the lambda directory.
If you want to run this sample, make sure you are running ASK CLI v2. For instructions on doing so and setting up an AWS IAM user for use with the CLI, see the technical reference docs.
From your terminal, try:
ask new --template-url https://github.com/alexa/skill-sample-nodejs-web-api-my-cactus --template-branch master
Select AWS with CloudFormation.
Use the defaults for each of the answers. This will set you up with the skill. From there:
To build this sample, first build the node packages:
cd lambdanpm installcd ..
Now, your AWS entity associated with the CLI will need access to create and manage the following resources: Cloudformation, IAM, AWS Lambda, Cloudfront, S3. Go to the AWS console, and for your IAM user, add these permissions.
For instance, adding the following policies will grant all the deploy access you will need:
- AWSLambdaFullAccess
- IAMFullAccess
- AmazonS3FullAccess
- CloudFrontFullAccess
- AWSCloudFormationFullAccess
Then you can deploy using: ask deploy from this directory. This will set up the stack, but will not upload the web assets needed. For that, you will need to get the name of the PublicRead S3 bucket created in the cloudformation deployment and set that as an environment variable. For instance:
export MY_CACTUS_S3="ask-pricklypete-default-skillstack-s3webappbucket-1234abc56789.s3.amazonaws.com"
Then, head over to the webapp directory. From there, run:
npm run build
Then:
npm run uploadS3
Alternatively, from the webapp directory, instead of using the npm run script, you can run:
aws s3 cp ./dist s3://$MY_CACTUS_S3/dist/ --recursive --acl public-read
where $MY_CACTUS_S3 is the S3 bucket name created in the cloudformation deployment during ask deploy.
This will take the files and upload them. From there, you can directly test and the code will point to the public website hosted in the cloud. If you would like to override the value provided for the publicly accessible link to a local one (for instance, if you are serving the assets from your local environment), simply open up the Lambda console, and override the "Domain" environment variable with your own. For more instructions head to the webapp directory.
If you want to make changes to this repo and have set up the skill using the previous methods, follow these instructions so you can pull the latest code when you need to or create your own pull requests.
From the top level directory, run:
git init .
Then add the origin with:
git remote add origin https://github.com/alexa/skill-sample-nodejs-web-api-my-cactus.git
or:
git remote add origin git@github.com:alexa/skill-sample-nodejs-web-api-my-cactus.git
Set the upstream to the main branch.
git branch --set-upstream-to=origin/master
Then, you can refresh by pulling:
git pull
Or, if this is aborted, you can always hard reset the branch:
git reset --hard origin/master
Now, you can pull whenever you need to update your code.
You can find the code and information about the Node.js web application under the webapp directory.
Please open bug reports on GitHub using GitHub issues. Include the steps taken to reproduce. You can use this for suggested improvements as well.
Feel free to fork and open a pull request if you have a fix or improvement to make, also!
See CONTRIBUTING for more information.
This library is licensed under the Amazon Software License.