Skip to content

A SvelteKit web app that shows alternative viewpoints on news articles to combat echo chambers and promote critical thinking 🧠

Notifications You must be signed in to change notification settings

raptor1820/bubbleburstwebsite

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

23 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

BUBBLE BURST!

Break free from your filter bubble. See the other side of the story.

Built with SvelteKit Powered by Bun Vercel Analytics

Live Demo β€’ Report Bug β€’ Request Feature


🎯 What is Bubble Burst?

In today's digital age, we're increasingly trapped in echo chambers where we only see content that confirms our existing beliefs. Bubble Burst is a web application designed to combat this by showing you alternative perspectives on any news article.

Simply paste a URL of any news article, and Bubble Burst will find related articles from different sources and viewpoints, helping you:

  • πŸ” Discover alternative perspectives on the same story
  • 🧠 Think critically about the news you consume
  • 🌐 Explore how different outlets cover the same events
  • πŸ’‘ Make informed decisions based on multiple viewpoints

✨ Features

  • πŸš€ Lightning Fast: Built with SvelteKit and Bun for optimal performance
  • 🎨 Retro Design: Nostalgic pixel-art aesthetic with smooth interactions
  • ⌨️ Keyboard Shortcuts: Press Enter to search instantly
  • πŸ“± Responsive: Works seamlessly on desktop and mobile devices
  • πŸ”— Direct Links: Click any result to read the full article
  • 🎯 Clean UI: Minimalist interface that puts content first

πŸš€ Quick Start

Prerequisites

Installation

# Clone the repository
git clone https://github.com/raptor1820/bubbleburstwebsite.git

# Navigate to the project directory
cd bubbleburstwebsite

# Install dependencies
bun install
# or: npm install

Development

Start the development server:

bun run dev
# or: npm run dev

Open http://localhost:5173 in your browser to see the app.

Building for Production

# Create a production build
bun run build

# Preview the production build
bun run preview

πŸ› οΈ Tech Stack

  • Framework: SvelteKit - Modern web framework with excellent performance
  • Runtime: Bun - Fast JavaScript runtime and toolkit
  • Styling: Vanilla CSS with custom properties and Google Fonts
  • Analytics: Vercel Analytics - Privacy-friendly analytics
  • Code Quality: ESLint + Prettier for consistent code formatting

πŸ“ Project Structure

bubbleburstwebsite/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ routes/
β”‚   β”‚   β”œβ”€β”€ +page.svelte      # Main page component
β”‚   β”‚   └── Card.svelte        # Article card component
β”‚   β”œβ”€β”€ lib/
β”‚   β”‚   └── index.js           # Utility functions
β”‚   └── app.html               # HTML template
β”œβ”€β”€ static/                    # Static assets
β”œβ”€β”€ package.json               # Project dependencies
β”œβ”€β”€ svelte.config.js           # SvelteKit configuration
└── vite.config.js             # Vite configuration

🎨 Design Philosophy

Bubble Burst features a distinctive neobrutalist design inspired by retro computing:

  • Press Start 2P font for the pixel-art header
  • Varela Round for clean, readable body text
  • Warm #FFEBCA background for comfortable reading
  • Bold black borders with shadow effects for depth
  • Subtle hover animations for interactive feedback

πŸ”Œ API Integration

The application connects to the Bubble Burst API:

https://apibubbleburst.ritwic.com/?url=[ARTICLE_URL]

The API analyzes the provided article and returns related content from different sources and perspectives.

You can also run the API locally. Visit this repo

🀝 Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Development Guidelines

# Run linting
bun run lint

# Format code
bun run format

πŸ“ License

This project is open source and available for educational purposes.

πŸ™ Acknowledgments

  • Built with SvelteKit
  • Fonts from Google Fonts
  • Inspired by the need for diverse perspectives in media consumption

πŸ“§ Contact

Ritwic - @raptor1820

Project Link: https://github.com/raptor1820/bubbleburstwebsite


Made with ❀️ to promote critical thinking and diverse perspectives

⭐ Star this repo if you found it helpful!


## Developing

Once you've created a project and installed dependencies with `npm install` (or `pnpm install` or `yarn`), start a development server:

```bash
npm run dev

# or start the server and open the app in a new browser tab
npm run dev -- --open

Building

To create a production version of your app:

npm run build

You can preview the production build with npm run preview.

To deploy your app, you may need to install an adapter for your target environment.

About

A SvelteKit web app that shows alternative viewpoints on news articles to combat echo chambers and promote critical thinking 🧠

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published