You can upload files to GitHub without any terminal commands by dragging and dropping them directly into your repository on the GitHub website. Navigate to your repo, drag files from your computer into the browser window, add a commit message, and click Commit changes. GitHub accepts files up to 25 MB each through the web interface, with a maximum of 100 files per upload.
Why Drag-and-Drop Is the Easiest Way to Add Files to GitHub
GitHub stores your project files in a repository (often called a "repo"). Every time you add or change a file, GitHub saves a snapshot called a "commit" — think of it as a save point you can always go back to. You do not need to install anything or type commands in a terminal. The GitHub website has a built-in drag-and-drop zone that lets you upload files straight from your desktop or file explorer. This is especially handy when you are working with AI app builders like Lovable or V0 and need to push exported assets — images, fonts, or configuration files — into your project repo. The web upload supports up to 25 MB per file and 100 files at a time. For anything larger, GitHub recommends Git Large File Storage, but for everyday project files the drag-and-drop method is more than enough.
Prerequisites
- A free GitHub account (sign up at github.com)
- A repository already created on GitHub (public or private)
- The files you want to upload saved on your computer
Step-by-step guide
Open your repository on GitHub
Open your repository on GitHub
Go to github.com and sign in. Click your profile picture in the top-right corner, then click "Your repositories" from the dropdown menu. Find the repository you want to upload files to and click its name to open it. You will land on the main code page that shows your existing files and folders.
Expected result: You see the file listing for your repository with the branch dropdown showing "main" (or your default branch name).
Navigate to the folder where you want to add files
Navigate to the folder where you want to add files
If you want to upload files into a specific folder, click that folder name in the file list. For example, if you have a "public" or "assets" folder, click into it first. If you want the files at the root level of your repo, stay on the main code page. The breadcrumb path near the top of the page shows your current location inside the repository.
Expected result: You are inside the correct folder (or at the repo root) where you want the new files to appear.
Open the Add file menu and choose Upload files
Open the Add file menu and choose Upload files
Look for the green "Add file" button near the top-right of the file list (above the table of files). Click it to reveal a dropdown menu with two options: "Create new file" and "Upload files." Click "Upload files." GitHub will open a new page with a large dotted-border rectangle that says "Drag files here to add them to your repository" and a "choose your files" link underneath.
Expected result: You see the upload page with a large drag-and-drop zone and a file picker link.
Drag your files into the upload zone
Drag your files into the upload zone
Open your computer's file explorer (Finder on Mac, File Explorer on Windows) and select the files you want to upload. Click and hold them, then drag them into the dotted rectangle on the GitHub page. You can also click the "choose your files" link to open a standard file picker dialog instead. GitHub shows a progress bar as it processes each file. You can upload up to 100 files at once, and each file must be 25 MB or smaller.
Expected result: All your files appear listed below the drag-and-drop zone with green checkmarks indicating they are ready to commit.
Write a commit message and commit the files
Write a commit message and commit the files
Scroll down below the file list to find the "Commit changes" section. In the first text box (the short description), type a brief summary of what you are uploading — for example, "Add logo images for landing page." The second, larger text box is optional and lets you add more detail. Make sure the radio button "Commit directly to the main branch" is selected (unless you want to create a new branch). Click the green "Commit changes" button.
Expected result: GitHub redirects you back to the file listing, and your newly uploaded files appear in the list.
Verify the upload
Verify the upload
Click on one of the files you just uploaded to confirm it opens correctly. For images, GitHub shows a preview. For text files, you see the content. Check the commit message shown next to each file — it should match what you typed in the previous step. If any file is missing, repeat the upload process for those files.
Expected result: Each uploaded file opens and displays correctly in the GitHub browser preview.
Complete working example
1# My Project Assets23This folder contains uploaded files for the project.45## File Upload Notes67- **Max file size**: 25 MB per file (web upload)8- **Max files per upload**: 100 files at a time9- **Supported file types**: all file types are supported1011## Folder Structure1213```14/assets15 /images ← logos, screenshots, icons16 /docs ← PDFs, guides, specs17 /fonts ← custom font files18```1920## How to Upload21221. Navigate to the target folder in this repo232. Click **Add file** → **Upload files**243. Drag files into the upload zone254. Write a short commit message265. Click **Commit changes**Common mistakes when dragging and Drop Files to a GitHub Repository
Why it's a problem: Trying to upload a file larger than 25 MB through the web interface
How to avoid: GitHub blocks files over 25 MB on the web. Compress the file, split it, or use Git LFS for large assets.
Why it's a problem: Uploading files to the wrong folder or the repo root by accident
How to avoid: Always check the breadcrumb path at the top of the page before clicking Add file → Upload files.
Why it's a problem: Leaving the commit message as the default "Add files via upload"
How to avoid: Write a descriptive message like "Add product screenshots for homepage" so your team knows what changed and why.
Why it's a problem: Uploading an entire node_modules or build folder
How to avoid: Only upload source files and assets. Build artifacts and dependency folders should be excluded — use a .gitignore file.
Best practices
- Always write a descriptive commit message that explains what the files are for.
- Organize files into folders before uploading to keep the repo tidy.
- Check file sizes before uploading — the 25 MB web limit catches many people off guard.
- Avoid uploading sensitive files like API keys, .env files, or credentials.
- Upload in batches if you have more than 100 files to add.
- Use lowercase filenames with hyphens (e.g., hero-image.png) for consistency.
- Verify uploads by clicking on files after committing to confirm they display correctly.
Still stuck?
Copy one of these prompts to get a personalized, step-by-step explanation.
I need to upload 50 image files to my GitHub repository. What is the best folder structure for organizing images in a web project repo, and what should I name the commit?
Frequently asked questions
Can I drag and drop an entire folder to GitHub?
Yes. When you drag a folder into the upload zone, GitHub automatically uploads all the files inside it and preserves the folder structure. The same 25 MB per-file and 100-file limits still apply.
What happens if I upload a file that already exists in the repo?
GitHub overwrites the existing file with the new version. The previous version is not lost — it is saved in the commit history, so you can always go back to it.
Is there a way to upload files larger than 25 MB without the terminal?
GitHub Desktop (a free app) lets you commit larger files through a graphical interface. For files over 100 MB, you need Git Large File Storage (LFS), which does require some setup.
Can I upload files to a private repository?
Yes. Drag-and-drop works exactly the same way for private repos. Only people with access to the repository can see the uploaded files.
How do I upload files exported from Lovable or V0 to GitHub?
Both Lovable and V0 can connect directly to GitHub. But if you prefer manual uploads, export or download your project files, then drag them into your GitHub repo using the steps in this tutorial.
Do I need to know how to code to upload files to GitHub?
No. Dragging and dropping files to GitHub requires zero coding knowledge. It works like uploading an attachment to an email. If your project grows more complex, teams like RapidDev can help you set up proper workflows.
Talk to an Expert
Our team has built 600+ apps. Get personalized help with your project.
Book a free consultation