Skip to content

readme updates to setup frontend correctly [IMP] #59

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 6 commits into
base: main
Choose a base branch
from

Conversation

Priyansh-max
Copy link
Contributor

@Priyansh-max Priyansh-max commented Apr 15, 2025

Closes #58

πŸ“ Description

As mentioned in the issue

πŸ”§ Changes Made

Added a env-example file
updated the readme to correctly setup the frontend for error free setup for new contributors

βœ… Checklist

  • [βœ… ] I have read the contributing guidelines.
  • [βœ… ] I have added tests that prove my fix is effective or that my feature works.
  • [βœ… ] I have added necessary documentation (if applicable).
  • [βœ… ] Any dependent changes have been merged and published in downstream modules.

Summary by CodeRabbit

  • Documentation
    • Improved and clarified setup instructions in the README, with explicit steps for configuring frontend and backend environments.
    • Added an example environment file for the frontend to guide users in setting up required Supabase credentials.

Copy link

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hello @Priyansh-max, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

Summary of Changes

This pull request addresses issue #58 and focuses on improving the frontend setup process for new contributors. I've added an .env-example file, updated the .gitignore to include .env and node_modules, and revised the README to provide clearer instructions for setting up the frontend. Additionally, I've updated the @supabase/supabase-js dependency from version 2.49.1 to 2.49.4, along with its related dependencies.

Highlights

  • Frontend Setup: The README has been updated with more detailed instructions for setting up the frontend, including creating a .env file and obtaining Supabase credentials.
  • Dependency Update: The @supabase/supabase-js dependency has been updated to version 2.49.4, along with its related dependencies @supabase/auth-js and @supabase/postgrest-js.
  • Environment Variables: An .env-example file has been added to the frontend to guide new contributors on setting up environment variables.

Changelog

Click here to see the changelog
  • Frontend/.gitignore
    • Added .env and node_modules to the .gitignore file.
  • Frontend/env-example
    • Created a new .env-example file with example Supabase credentials.
  • Frontend/package-lock.json
    • Updated @supabase/supabase-js from version 2.49.1 to 2.49.4.
    • Updated @supabase/auth-js from version 2.68.0 to 2.69.1.
    • Updated @supabase/postgrest-js from version 1.19.2 to 1.19.4.
  • Frontend/package.json
    • Updated @supabase/supabase-js from version 2.49.1 to 2.49.4.
  • README.md
    • Revised the frontend setup instructions to be more detailed and user-friendly.
    • Clarified the steps for obtaining Supabase credentials.
    • Reordered and reworded sections for better clarity.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point in your pull request via creating an issue comment (i.e. comment on the pull request page) using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in issue comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist is currently in preview and may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with πŸ‘ and πŸ‘Ž on @gemini-code-assist comments to provide feedback.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.


A frontend's start,
With env's gentle art,
Keys in their place,
Setup with grace,
A smooth launch, a brand new start.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

Copy link

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request focuses on improving the setup instructions in the README and providing an example environment file for the frontend. The changes aim to make it easier for new contributors to set up the project correctly. Overall, the changes are good and helpful, but there are a few areas that could be improved for clarity and consistency.

Summary of Findings

  • README clarity and consistency: The README updates are generally good, but there are some inconsistencies in formatting and wording that could be improved for better readability and a more professional look.
  • Backend setup instructions: The backend setup instructions could be more concise and clear, especially regarding the Supabase credentials and Groq API key.

Merge Readiness

The pull request is almost ready for merging. Addressing the comments regarding README clarity and backend setup instructions will further improve the developer experience. I am unable to directly approve the pull request, and users should have others review and approve this code before merging.

@Priyansh-max
Copy link
Contributor Author

@ishaanxgupta please review this pr
I guess this must be updated asap for new contributors

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I see some changes in the version, I am not sure whether there will be some version conflicts with the existing functionality. Can you please confirm if the auth is working as it was working before?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes it does work perfectly, moreover it is the latest version so it should be a problem

@Priyansh-max
Copy link
Contributor Author

@ishaanxgupta please review this again.

Copy link

coderabbitai bot commented May 29, 2025

Walkthrough

A new environment variable example file was added for the frontend, specifying Supabase configuration placeholders. The README was reorganized and clarified, detailing explicit setup steps for both frontend and backend, including instructions for creating environment files and configuring Supabase credentials.

Changes

Files / Group Change Summary
Frontend/env-example Added example environment file with Supabase variable placeholders for frontend configuration.
README.md Clarified and reorganized setup instructions for frontend and backend, removed redundancies.

Assessment against linked issues

Objective Addressed Explanation
Add env-example file for frontend Supabase credentials (#58) βœ…
Update README with clear frontend setup steps, including .env instructions (#58) βœ…

Poem

In the warren, a file appears,
For Supabase secrets, to calm your fears.
The README now clear, with steps so neat,
Hop to your setupβ€”no more defeat!
With .env in paw, you’re ready to go,
A rabbit’s guide to setup, in one simple flow.
πŸ₯•βœ¨


πŸ“œ Recent review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

πŸ“₯ Commits

Reviewing files that changed from the base of the PR and between 392e755 and 0b39995.

πŸ“’ Files selected for processing (1)
  • README.md (2 hunks)
🚧 Files skipped from review as they are similar to previous changes (1)
  • README.md

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❀️ Share
πŸͺ§ Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Explain this complex logic.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai explain this code block.
    • @coderabbitai modularize this function.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read src/utils.ts and explain its main purpose.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
    • @coderabbitai help me debug CodeRabbit configuration file.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai full review to do a full review from scratch and review all the files again.
  • @coderabbitai summary to regenerate the summary of the PR.
  • @coderabbitai generate docstrings to generate docstrings for this PR.
  • @coderabbitai generate sequence diagram to generate a sequence diagram of the changes in this PR.
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
  • @coderabbitai help to get help.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

♻️ Duplicate comments (1)
README.md (1)

104-104: Clarify .env creation instruction
Rephrase this step to be more direct, for example:

Copy the contents of env-example into a new file named .env in the frontend directory.

🧹 Nitpick comments (7)
Frontend/env-example (1)

1-2: Standardize environment example filename
To align with common conventions and ensure compatibility with dotenv tooling, consider renaming this file to .env.example (or env.example) instead of env-example.

README.md (6)

91-96: Verify directory name casing
The command cd frontend assumes a lowercase frontend directory, but the project structure uses Frontend. Please ensure the casing matches exactly to avoid errors on case-sensitive file systems.


108-113: Show credential variables in a code snippet
For better clarity, present the Supabase credentials as an example .env snippet:

VITE_SUPABASE_URL=<your-project-url>
VITE_SUPABASE_ANON_KEY=<your-anon-key>

116-119: Clarify backend directory navigation
To avoid confusion, you could combine these steps or show the full path sequence. For example:

cd backend/app

137-140: Consolidate Supabase credential instructions
The backend Supabase setup repeats the frontend steps. Consider referencing the frontend section or summarizing both in one spot to avoid redundancy.


166-167: Include Groq API key example
Illustrate how to add the Groq API key into the .env:

GROQ_API_KEY=<your-groq-api-key>

177-182: Clarify server start commands with context
Make it explicit which directory each command should be executed from. For example:

# From project root
cd frontend && npm run dev

# In a new terminal, from project root
cd backend/app && uvicorn main:app --reload
πŸ“œ Review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

πŸ“₯ Commits

Reviewing files that changed from the base of the PR and between aa15c5d and 392e755.

πŸ“’ Files selected for processing (2)
  • Frontend/env-example (1 hunks)
  • README.md (2 hunks)

@Priyansh-max
Copy link
Contributor Author

Please review it @chandansgowda

@Priyansh-max Priyansh-max changed the title readme updates to setup frontend correctly readme updates to setup frontend correctly [IMP] May 29, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

DOCS UPDATE: frontend setup readme updates required
2 participants