This project is a SvelteKit-based web application designed to manage and visualize data from Google Sheets. It connects to your Google Drive, allows you to search and select a sheet, edit its content directly within the app, and view simple real-time visualizations.
- Google Drive Integration: Search for and select Google Sheets stored in your Drive.
- Sheet Editing: Edit the content of a selected sheet within the web app.
- Real-Time Visualization: Display simple visualizations of the sheet data to gain insights quickly.
- Drinks Shop Example: Pre-configured to work with a drinks shop dataset.
Before you begin, ensure you have the following:
- Node.js (v16 or higher) and npm installed.
- A Google Cloud project with the Google Sheets and Google Drive APIs enabled.
- OAuth 2.0 credentials (Client ID and Client Secret) for authenticating with Google.
git clone https://github.com/Chulinuwu/drinkme
cd drinkme
npm install
Create a .env
file in the project root with the following:
SECRET_CLIENT_ID=your_client_id
SECRET_CLIENT_SECRET=your_client_secret
REDIRECT_URL=your_url_example_http://localhost:5173
Replace your-client-id
, your-client-secret
, and your-redirect-uri
with your actual Google Cloud OAuth 2.0 credentials.
- Visit the Google Cloud Console.
- Create a new project or select an existing one.
- Navigate to APIs & Services > Credentials.
- Click Create Credentials and choose OAuth Client ID.
- Configure the consent screen if prompted.
- Choose Web Application as the application type.
- Enter a name (e.g., "Drinks Shop Editor Web App").
- Add the following to the Authorized redirect URIs:
http://localhost:5173
- Your production URL if applicable (e.g.,
https://yourdomain.com
).
- Click Create and save the generated Client ID and Secret.
npm run dev
Visit http://localhost:5173
to access the app.
- Authentication: Log in using your Google account to grant the app access to your Google Drive.
- Search for Sheets: Use the search functionality to find a specific Google Sheet in your Drive.
- Select and Edit: Choose a sheet, then view and modify its data directly within the app.
- Visualize Data: View a real-time visualization of your sheet data for insights.
The app is configured to manage a drinks shop dataset, including columns for drink names, prices, and inventory levels. Real-time visualizations help track trends and insights.
To deploy the app:
-
Build the project:
npm run build
-
Deploy the
build
folder to your preferred hosting service (e.g., Vercel, Netlify).
- Add user roles and permissions.
- Integrate advanced data visualizations.
- Enable offline access with service workers.
Feel free to submit issues or pull requests to improve the app.
This project is licensed under the MIT License. See the LICENSE
file for more details.