This repo is designed to provide space to code a fullstack app. It contains node modules and folders for databases, routes, api requests, react components, and redux actions and creators. Let's get going!
-
Clone this repo, navigate to it, install packages, and start the server with
npm run dev
Tip
You may also want to start a new branch
cd my-fullstack-collection npm i git checkout -b <branchname> npm run dev
More about using npm
vs npx
- When running knex, run
npm run knex <command>
, e.g.npm run knex migrate:latest
rather than usingnpx
-
First, decide what you would like to keep a collection of. This could be a repo for keeping track of movies, books, gifs, cars, rocks, anything you fancy, but keep it simple!
More about your collection
Note: the aim is to have some simple data. If you think you might need more than one database table, or have lots of details you want to store, how could you simplify the information you're keeping track of? Leave more complex data until later in the project. For example, I want to keep track of books that I want to read, ones that I have read, and ones that I own. To start with though, let's keep track of the books themselves. My data might look like:
id title author 1 Ready Player One Ernest Cline 2 Throwing Rocks at the Google Bus Douglas Rushkoff
Our first job is getting something showing on the front end from our database. Here's a list of steps in case they are useful. You can build in any order you like though ;)
- Design a database to store a list of your things (e.g. books)
- Build the migrations and seed data
- Build an API (back end route) to get the information from your database
- Test your API with Insomnia
-
Build a React component with static html
-
Build Redux reducer. Start with a hardcoded initial state
Tip
For example:
const initialState = [{ id: 1, title: 'Ready Player One', author: 'Ernest Cline' }]
-
Use
useAppSelector
to display the redux state you hardcoded in the React Component
- Build an API client in the front end to request the information from your routes
- Build Thunk actions to use the API and get the information
- Build Redux actions to save task data from the thunk
- Use
useAppDispatch
anduseEffect
to dispatch the thunk when your app loads
- Include the ability to add a new record (will need a form in your components)
- Include the ability to remove/delete records
- Include the ability to update records (e.g. for correcting typos)
More about stretch challenges
- Forms can be tough to build accessibly. First ensure all parts of your form can be reached and used with keyboard-only navigation. Then test your form page with the WAVE browser extension, and fix any accessibility issues it detects
- Is there any complex data you chose to not include earlier or any way you could expand this dataset?
- You might have some other information (e.g. unread books vs. read books) that should be included in your database design, and this may require adjusting your database design
- Could you add an external API (maybe an inspirational quote in the footer?)
- If you haven't already, CSS!