Fork this repo to your own github and then clone it to your computer.
You'll need to have Ruby version 3.1.1 installed with your ruby version manager (rbenv, rvm, etc) as well as postgres (you can install postgres using brew install postgres or via the Postgres.app)
This is using the brand spanking new release of Rails 7. Go ahead and do bundle install and yarn install and make sure all the dependencies install correctly.
Create and seed your database (check seeds.rb if you want to see how they are created)
rails db:setuprails db:seed
You can also completely reset the database at any time and reseed it all at once by running
rails db:reset
good to be able to reset your database if you get it into a strange state (obviously run that only in development)
To run a dev server that it automatically compiling JS/CSS and running Puma the new command is bin/dev instead of rails s
(repeat run bin/dev or you will wonder why your front end changes aren't appearing!)
Once you are up and running you should see something like this
Try not to laugh at my amazing front-end design
You have been hired as the one and only full stack developer for a startup that is creating a book rating and sharing system (they see Goodreads and think they can do better!)
There is a folder in this repo called "User Stories" in which you'll get a sense of how tickets might come in written by a product team. There may also be variations on whether you want to focus more on the back-end or front-end learning. And they'll be some supplemental reading and resources for you listed in each one as well.
It is one thing to try to understand Ruby and Rails from an abstract perspective, and another to dig in and build features. I hope having to implement something yourself will both bring you the excitement of seeing something exist that didn't exist before you created it, and lead you to the places in which you can dig into the unknowns in small steps. What do I need to know to do /this/ right now?
There are rspec tests and you are encouraged to play around with writing more! To run tests run
rake spec
This is outlined in the very first user story, but your flow should be to checkout a new branch to implement something
git checkout -b feature/my-first-feature
make commits on that branch
git commit -m 'added models and tests for blah'
git commit -m 'styling for our widget page
and when you are ready for someone to look at the code push that branch up to github
git push origin feature/my-first-feature
and open a pull request
Tailwind CSS (CSS framework) https://tailwindui.com/
Daisy UI (free component library) https://daisyui.com
Rails 7 docs https://guides.rubyonrails.org/