base on Learn the foundational skills of building full stack web applications. <div> <h1 align="center"><a href="https://www.epicweb.dev/workshops/full-stack-foundations">🔭 Full Stack Foundations</a></h1> <strong> Learn the foundational tools and skills of building web applications </strong> <p> In this workshop we'll go through exercises in a real world app that will help you learn some key concepts for building web applications. </p> </div> <div align="center"> <a alt="Epic Web logo with the words Deployed Version" href="https://foundations.epicweb.dev/" > <img width="300px" src="https://github-production-user-asset-6210df.s3.amazonaws.com/1500684/254000390-447a3559-e7b9-4918-947a-1b326d239771.png" /> </a> </div> <hr /> <!-- prettier-ignore-start --> [![Build Status][build-badge]][build] [![GPL 3.0 License][license-badge]][license] [![Code of Conduct][coc-badge]][coc] <!-- prettier-ignore-end --> ## Prerequisites - Some [experience with JavaScript](https://kentcdodds.com/blog/javascript-to-know-for-react) - Some [experience with TypeScript](https://www.totaltypescript.com/tutorials) - Some [experience with React](https://kcd.im/beginner-react) - Some [experience with Node.js](https://nodejs.dev/en/learn) ## System Requirements - [git][git] v2.18 or greater - [NodeJS][node] v20 or greater - [npm][npm] v8 or greater All of these must be available in your `PATH`. To verify things are set up properly, you can run this: ```shell git --version node --version npm --version ``` If you have trouble with any of these, learn more about the PATH environment variable and how to fix it here for [windows][win-path] or [mac/linux][mac-path]. ## Setup Use the Epic Workshop CLI to get this setup: ```sh nonumber npx --yes epicshop@latest add full-stack-foundations ``` If you experience errors here, please open [an issue][issue] with as many details as you can offer. ## Exercises You'll find all the exercises in the `exercises` directory. The structure of the workshop apps is described below, but most of the time you should be able to simply run the app and navigate around the different exercises using the application (there are even buttons to open the right exercise file right in your editor). The purpose of the exercise is **not** for you to work through all the material. It's intended to get your brain thinking about the right questions to ask me as _I_ walk through the material. ## Running the app To get the app up and running (and really see if it worked), run: ```shell npm start ``` Now open your browser to the address that's logged out for you and you're good to get started! ## Running the tests The test script in the `package.json` runs the tests on the solutions (these should all pass). To run the tests against your own work, you simply open the problem page and click the "Test" tab. ## Launching your editor The application has several buttons which will launch your editor to the right file. There are a lot of files in this workshop so you'll be using this feature a lot to get to the right place at the right time. This should just work™️ (it looks at your currently running processes and chooses the editor based on that). If it doesn't guess correctly, create a `.env` file in the root of this project and add an environment variable called `EPICSHOP_EDITOR` with the value being set to the path to your editor's executable. For example, if you're using VS Code on Windows, you'd add this to your `.env` file: ``` EPICSHOP_EDITOR='"C:\Program Files\Microsoft VS Code\bin\code.cmd"' ``` Make certain that if the path includes spaces that you wrap the path in quotes as above (note the use of single quotes wrapping the double quotes!). The value of `EPICSHOP_EDITOR` should be the command that you would run in your terminal to open your editor from the command line. This means, the first thing should be the path to the executable for your editor (or the command if you have one in your `PATH`). So you may be able to get away with doing something as simple as this: ``` EPICSHOP_EDITOR=code ``` ## Exercises - `exercises/*.*/README.md`: Exercise background information - `exercises/*.*/*.problem.*/README.*.md`: Problem Instructions - `exercises/*.*/*.problem.*/*.tsx`: Exercise with Emoji helpers 👈 You spend most of your time here. - `exercises/*.*/*.solution.*/*.tsx`: Solved version The purpose of the exercise is **not** for you to work through all the material. It's intended to get your brain thinking about the right questions to ask me as _I_ walk through the material. ## Helpful Emoji 🐨 🦺 💰 📝 🦉 📜 💣 💪 🏁 👨‍💼 🚨 🧝‍♀️ Each exercise has comments in it to help you get through the exercise. These fun emoji characters are here to help you. - **Kody the Koala** 🐨 will tell you when there's something specific you should do - **Lily the Life Jacket** 🦺 will help you with any TypeScript-specific parts of the exercises - **Marty the Money Bag** 💰 will give you specific tips (and sometimes code) along the way - **Nancy the Notepad** 📝 will encourage you to take notes on what you're learning - **Olivia the Owl** 🦉 will give you useful tidbits/best practice notes - **Dominic the Document** 📜 will give you links to useful documentation - **Barry the Bomb** 💣 will be hanging around anywhere you need to blow stuff up (delete code) - **Matthew the Muscle** 💪 will indicate that you're working with an exercise - **Chuck the Checkered Flag** 🏁 will indicate that you're working with a final - **Peter the Product Manager** 👨‍💼 helps us know what our users want - **Alfred the Alert** 🚨 will occasionally show up in the test failures with potential explanations for why the tests are failing - **Kellie the Co-worker** 🧝‍♀️ your co-worker who sometimes does work ahead of your exercises ## Workshop Feedback Each exercise has an Elaboration and Feedback link. Please fill that out after the exercise and instruction. At the end of the workshop, please go to this URL to give overall feedback. Thank you! https://kcd.im/rmx-workshop-ws-feedback <!-- prettier-ignore-start --> [npm]: https://www.npmjs.com/ [node]: https://nodejs.org [git]: https://git-scm.com/ [build-badge]: https://img.shields.io/github/actions/workflow/status/epicweb-dev/full-stack-foundations/deploy.yml?branch=main&logo=github&style=flat-square [build]: https://github.com/epicweb-dev/full-stack-foundations/actions?query=workflow%3Adeploy [license-badge]: https://img.shields.io/badge/license-GPL%203.0%20License-blue.svg?style=flat-square [license]: https://github.com/epicweb-dev/full-stack-foundations/blob/main/LICENSE [coc-badge]: https://img.shields.io/badge/code%20of-conduct-ff69b4.svg?style=flat-square [coc]: https://kentcdodds.com/conduct [win-path]: https://www.howtogeek.com/118594/how-to-edit-your-system-path-for-easy-command-line-access/ [mac-path]: http://stackoverflow.com/a/24322978/971592 [issue]: https://github.com/epicweb-dev/full-stack-foundations/issues/new <!-- prettier-ignore-end --> ", Assign "at most 3 tags" to the expected json: {"id":"3814","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"