A Flask-based web application that provides book recommendations using the Open Library API. The application features a modern UI built with Tailwind CSS, allowing users to search for books and get recommendations.
- Search for books by title, author, or keywords
- Get random book recommendations
- View book details including cover images, authors, and publication years
- Responsive design that works on different screen sizes
- Custom 404 error page
- Backend: Flask (Python)
- Frontend: HTML, JavaScript, Tailwind CSS
- API: Open Library API
- Package Management: npm (for Tailwind CSS)
- Python 3.7+
- pip (Python package manager)
- Node.js and npm (for Tailwind CSS)
git clone https://github.com/bittricky/book-recommendations.git
cd book-recommendations# Create a virtual environment
python -m venv venv
# Activate the virtual environment
# On Windows
venv\Scripts\activate
# On macOS/Linux
source venv/bin/activatepip install -r requirements.txt# Install npm dependencies
npm install
# Build the CSS
npm run build:css# Set Flask to development mode
# On Windows
set FLASK_ENV=development
# On macOS/Linux
export FLASK_ENV=development
# Run the application
python run.pyThe application will be available at http://localhost:5000
For frontend development with hot-reloading of Tailwind CSS:
# Run Tailwind CSS in watch mode
npm run watch:cssThis will automatically rebuild the CSS whenever you make changes to the Tailwind configuration or HTML files.
For backend development, you can use Flask's debug mode which is enabled by default in the run.py file. This allows for automatic reloading of the server when Python files are changed.
book-recommendations/
├── app/ # Application package
│ ├── __init__.py # Application initialization
│ ├── routes.py # Route definitions
│ ├── services.py # Service layer (API interactions)
│ ├── static/ # Static files
│ │ ├── scripts/ # JavaScript files
│ │ └── styles/ # CSS files
62F9
│ └── templates/ # HTML templates
├── venv/ # Virtual environment (not in repository)
├── .gitignore # Git ignore file
├── package.json # npm package configuration
├── requirements.txt # Python dependencies
├── run.py # Application entry point
└── tailwind.config.js # Tailwind CSS configuration
- Open Library API for providing book data
- Tailwind CSS for the utility-first CSS framework
- Flask for the web framework