# SPARQLWorks™

[![SPARQLWorks](https://img.shields.io/badge/SPARQLWorks-0.6.1a-blue)](https://sparqlworks.openlinksw.com/)
[![License](https://img.shields.io/badge/License-Apache%202.0-green.svg)](https://opensource.org/licenses/Apache-2.0)
[![OpenLink Software](https://img.shields.io/badge/OpenLink-Software-orange)](https://www.openlinksw.com/)

> An interactive SPARQL Query Visualizer and graph visualizer for RDF/Linked Data

SPARQLWorks™ is a modern web application that allows you to compose, run, and visualize SPARQL queries against any SPARQL 1.1 compliant endpoint. Built with cutting-edge web technologies, it transforms complex RDF data into interactive, explorable knowledge graphs.

## 🎯 What is SPARQLWorks?

SPARQLWorks bridges the gap between SPARQL query writing and data visualization. Instead of staring at raw query results, you can immediately see your data as a dynamic graph where:

- **Nodes** represent entities, literals, and concepts
- **Edges** show relationships between entities
- **Interactive exploration** allows drilling down into details
- **Filtering and customization** help focus on relevant data

## ✨ Key Features

- **Dual Query Modes**: Basic mode for beginners, Advanced mode for experts
- **Real-time Graph Visualization**: Powered by D3.js for smooth, interactive graphs
- **Intelligent Filtering**: Filter by RDF types, properties, and node groups
- **Authentication Support**: OAuth 2.0 and Bearer token authentication
- **Shareable Links**: Encode complete query configurations in URLs
- **Responsive Design**: Works on desktop and mobile devices
- **Multiple Endpoints**: Connect to any SPARQL endpoint (DBpedia, Wikidata, etc.)

## 🚀 Quick Start

1. **Open SPARQLWorks** in your web browser
2. **Choose an endpoint** (e.g., `https://demo.openlinksw.com/sparql`)
3. **Write a query** in Basic or Advanced mode
4. **Click Run** to execute and visualize
5. **Explore the graph** by clicking nodes and hovering over edges

## 📖 Documentation

- [Features](Features.md) - Complete feature overview
- [User Guide](User-Guide.md) - Step-by-step usage instructions
- [Query Modes](Query-Modes.md) - Understanding Basic vs Advanced
- [Graph Visualization](Graph-Visualization.md) - How to interact with graphs
- [Examples](Examples.md) - Sample queries and visualizations
- [Authentication](Authentication.md) - Setting up credentials
- [Controls and Settings](Controls-and-Settings.md) - Customization options
- [URL Parameters](URL-Parameters.md) - Sharing and configuration
- [Technical Details](Technical-Details.md) - Architecture and implementation

## 🛠️ Technologies Used

- **Frontend**: HTML5, CSS3, JavaScript (ES6+)
- **Visualization**: D3.js v7
- **UI Framework**: Tailwind CSS
- **Code Editor**: Ace Editor
- **Graph Processing**: JSON-LD, RDF/Linked Data
- **Authentication**: OAuth 2.0 with PKCE

## 📄 License

SPARQLWorks™ is licensed under the Apache License, Version 2.0. See [LICENSE](../LICENSE) for details.

## 🤝 Contributing

SPARQLWorks is developed by [OpenLink Software](https://www.openlinksw.com/) and Daniel Heward-Mills, as part of their commitment to advancing Semantic Web technologies.

---

**Version**: 0.6.1a | **Copyright**: © 2025 OpenLink Software