Echoes - Quotes From Around The World 🌍

Echoes is a modern web application that offers inspiring quotes from around the world. It aims to inspire users by providing access to wisdom and insights in different languages, all within a beautiful, responsive interface.

Live Preview | API Documentation

✨ Features

🌐 Multilingual Interface - Full internationalization support
🧩 Developer API - RESTful endpoints for programmatic access
⚡ Performance - Fast loading and optimized for best user experience
📱 Responsive Design - Optimized for all devices from mobile to desktop
🔄 Quote Discovery - Random quotes with author and source information
📚 Language Diversity - Quotes in multiple languages from around the world
🔍 Advanced Filtering - Search by author, language or combine multiple filters
🎨 Theme Options - Light/dark mode with automatic system preference detection

🛠️ Technologies

The application is built with modern web technologies:

🔷 TypeScript - Static type checking
🌐 Next-i18next - Internationalization
📊 Framer Motion - Animation library
🎨 Next-Themes - Theme management
💨 Tailwind CSS - Utility-first CSS framework
⚛️ Next.js - React framework with SSR/SSG support

🚀 Getting Started

Prerequisites

Bun 1.0 or higher

Installation

# Clone the repository
git clone https://github.com/Taiizor/Echoes.git

# Navigate to the project directory
cd Echoes

# Install dependencies
bun install

# Start the development server
bun run dev

You can access the application at http://localhost:3000.

Docker Deployment

# Build and run with Docker Compose
docker-compose up -d

⚙️ Configuration

Adding Quotes: Edit the data/quotes.json file to add new quotes
Theme: Customize the tailwind.config.js file to change color schemes
Translations: Modify files in the public/locales folder to update or add translations

📖 API Documentation

Echoes provides a comprehensive API for developers to access the quotes programmatically:

Endpoints

GET /api/quotes          # Get all quotes (paginated)
GET /api/quotes/:id      # Get quote by ID
GET /api/quotes/random   # Get random quote

Query Parameters

Random Quote Filters

# By language
GET /api/quotes/random?lang=tr

# By multiple languages (comma-separated)
GET /api/quotes/random?lang=en,tr

# By author
GET /api/quotes/random?author=Einstein

# By multiple authors (comma-separated)
GET /api/quotes/random?author=Einstein,Gandhi

# Combined filters
GET /api/quotes/random?author=Yunus&lang=tr
GET /api/quotes/random?author=Einstein,Gandhi&lang=en,tr

Pagination for All Quotes

GET /api/quotes?page=1&perPage=10

🤝 Contributing

Contributions are welcome and appreciated! Here's how you can contribute:

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Add your changes
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

Types of contributions:

Improving or adding translations
Adding new quotes to the database
Fixing bugs or improving performance
Adding new features or enhancing existing ones

📄 License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

Made with ❤️ by Taiizor

Taiizor/Echoes