/jump-to-code

Open files in VSCode from GitHub repos

Primary LanguageTypeScriptMIT LicenseMIT

🦘 Jump to Code

A dead simple browser extension that allows you to jump from a file in GitHub to that file in your local workspace.

I was already working on a Chrome extension when I saw this tweet & decided I could fix this!

⚠️WARNING⚠️ this extension is very unfinished. I've only tested it on my machine and it barely works at that. I welcome contributions and don't plan to spend any more time on this unless someone begs me to.

How it works

This extension only works with VSCode installed. Also I doubt it works on Windows right now. (Is that you drafting a PR I hear??)

  1. Open a GitHub repo (like this one!)
  2. Click the extension in your chrome bar
  3. Configure where on your local file system the repo is located
  4. Open a file in that repo on GitHub
  5. Click the ... on a line number
  6. Click "Jump to code..."
  7. ???
  8. Profit!

Demo video

jump2code.mp4

Roadmap

  • Validate file path with a Regex (/must/be/like/this)
  • See if it works on Windows/other OSes
  • Add a "Jump to code" button w/o line number to the action bar on GitHub files
  • Add a way to "jump to repo" anywhere within a GH repo

Stretch goals (accepting PRs!)

  • GitLab support
  • Other editor support
  • Better UX in popup
  • Slim down app (do we really need react? probably not. can I be bothered to write plain html/css/js? hell no!)

Development

This is a Plasmo extension project bootstrapped with plasmo init.

Getting Started

First, run the development server:

pnpm dev
# or
npm run dev

Open your browser and load the appropriate development build. For example, if you are developing for the chrome browser, using manifest v3, use: build/chrome-mv3-dev.

You can start editing the popup by modifying popup.tsx. It should auto-update as you make changes. To add an options page, simply add a options.tsx file to the root of the project, with a react component default exported. Likewise to add a content page, add a content.ts file to the root of the project, importing some module and do some logic, then reload the extension on your browser.

For further guidance, visit our Documentation

Making production build

Run the following:

pnpm build
# or
npm run build

This should create a production bundle for your extension, ready to be zipped and published to the stores.

Submit to the webstores

The easiest way to deploy your Plasmo extension is to use the built-in bpp GitHub action. Prior to using this action however, make sure to build your extension and upload the first version to the store to establish the basic credentials. Then, simply follow this setup instruction and you should be on your way for automated submission!