LitCoach

LitCoach is a Chrome extension that gives you real-time feedback on LeetCode problems and automatically syncs your solutions to GitHub—making it easy to track your progress and showcase activity while you prep for interviews.

Local Development

Ensure you have the following installed and set up before proceeding:

• Node.js

• Python 3.12+

• Poetry

• Stripe CLI

• MongoDB Atlas

• OpenAI API Key

• GitHub OAuth App

• Stripe Account

Important

When creating the GitHub OAuth App, set the Authorization callback URL to:
https://pbkbbpmpbidfjbcapgplbdogiljdechf.chromiumapp.org This is required for authentication to work inside the Chrome Extension.

1. Clone the repository:

   git clone https://github.com/rezabrizi/LitCoach.git
   cd LitCoach

2. Copy the environment config file:

   cp .env.example .env

3. Open .env and fill in all the required values:

   # Frontend
   VITE_API_URL=http://127.0.0.1:8000
   VITE_GITHUB_CLIENT_ID=<your_github_client_id>
   
   # Backend
   MONGO_DB_URI=<your_mongo_connection_string>
   OPENAI_KEY=<your_openai_api_key>
   GITHUB_CLIENT_ID=<your_github_client_id>
   GITHUB_CLIENT_SECRET=<your_github_client_secret>
   STRIPE_API_KEY=<your_stripe_secret_key>
   STRIPE_WEBHOOK_SECRET=<your_stripe_webhook_secret>

Note

Need help finding these values? Use the links in the Prerequisites section above.

4. Create a Python virtual environment (using Python 3.12):

   python3.12 -m venv venv
   source venv/bin/activate  # On Windows, use: venv\Scripts\activate

5. Install backend dependencies with Poetry:

   poetry install

6. Install frontend dependencies:

   npm install

7. Start the backend server:

   uvicorn api.app:app --reload

8. Start the frontend development server:

   npm run dev

9. Start the Stripe webhook listener:

   stripe listen --forward-to http://localhost:8000/stripe/webhook

10. Open Chrome and go to: chrome://extensions/

11. Toggle Developer Mode on (top right)

12. Click "Load unpacked"

13. Select the dist folder from the repo