🚀 A simple and user-friendly GUI client for Google Cloud Spanner, built with Next.js and React.
- 🔍 Easy navigation of Spanner instances and databases
- ⚡ Execute SQL queries
- 📊 View query results in a clean, tabular format
- 📜 Query history for quick access to past operations
- 🎨 Syntax highlighting and query formatting
- 📱 Responsive design for desktop and mobile use
git clone https://github.com/esh2n/spanner-gui.git
cd spanner-gui
bun install
bun run dev.tauriEnsure you have set up your Google Cloud credentials. You can do this by setting the GOOGLE_APPLICATION_CREDENTIALS environment variable to point to your service account key file.
export GOOGLE_APPLICATION_CREDENTIALS="/path/to/your/service-account-key.json"
bun run dev.tauri
- Enter your Google Cloud Project ID and click "Initialize"
- Select a Spanner instance from the dropdown
- Choose a database from the selected instance
- Write your SQL query in the editor
- Click "Execute" to run the query
- View results in the table below
- Access query history in the "History" tab
Handles all Spanner-related operations.
{
type: 'instances' | 'databases' | 'query',
projectId: string,
instanceId?: string,
databaseId?: string,
query?: string
}- For
instances: Array of instance names - For
databases: Array of database names - For
query: Array of result rows
We welcome contributions! Here's how you can help:
- 🍴 Fork the repository
- 🌿 Create your feature branch:
git checkout -b my-new-feature - 💾 Commit your changes:
git commit -am 'Add some feature' - 🚀 Push to the branch:
git push origin my-new-feature - 🎉 Submit a pull request
- 🔒 Implement user authentication
- 📊 Add visual query plan explanation
- 🔄 Support for DML operations (INSERT, UPDATE, DELETE)
- 📈 Query performance metrics
- 🌓 Dark mode support
- 🧪 Comprehensive unit and integration testing
MIT