Welcome to the Booknest, a Ruby on Rails application that allows users to sign up, log in, and borrow books. Each book has details such as a title, description, author, availability status, and a unique ISBN number.
- User Authentication: Secure signups and logins using Rails 8 authentication.
- Book Management: View books with details like title, description, author, and availability status.
- Borrowing System: Users can check if a book is available and borrow it.
- Database: Uses SQLite (Rails 8 default).
Follow these steps to get the application running locally:
Make sure you have the following installed:
- Ruby (latest compatible version with Rails 8)
- Rails 8
- Bundler
- SQLite3
-
Clone the repository
git clone https://github.com/ndegwa007/Booknest.git cd Booknest -
Install dependencies
bundle install
-
Set up the database
rails db:migrate rails db:seed # Seeds the database with book data -
Start the Rails server
rails server
-
Access the application Open your browser and go to:
http://localhost:3000 -
Running tests
rspec
- Sign up or log in to access the library.
- Browse the available books.
- Check book availability.
- Borrow books and return them when done.
Contributions are welcome! Please follow these steps:
- Fork the repository.
- Create a new branch (
git checkout -b feature-branch). - Make your changes and commit them (
git commit -m 'Add new feature'). - Push to the branch (
git push origin feature-branch). - Open a Pull Request.
This project is open-source and available under the MIT License.
For any issues or suggestions, feel free to open an issue or reach out to Martin Ndegwa.