Replit integration

GitHub Import Missing Files on Replit

You imported a GitHub repository into Replit, but the project is incomplete. Some files and directories are missing, the app will not start, and you see errors about modules, configurations, or assets that should exist but do not.

Replit's GitHub import process does not always capture every file from a repository. Files excluded by .gitignore, files over certain size limits, symlinks, and files in submodules are commonly missed during import. The import also does not run post-clone hooks or setup scripts.

This is particularly confusing because the repository looks complete on GitHub but the Replit project is missing critical pieces needed to run the application.

Error Messages You Might See

MODULE_NOT_FOUND: Cannot find module './config' FileNotFoundError: .env: No such file or directory Error: Cannot find package.json ERROR: Could not find a required file: index.html
MODULE_NOT_FOUND: Cannot find module './config'FileNotFoundError: .env: No such file or directoryError: Cannot find package.jsonERROR: Could not find a required file: index.html

Common Causes

  • .gitignore exclusions — files like .env, node_modules, build artifacts, and config files are excluded by .gitignore and not imported
  • Large files excluded — files over Replit's size limit are silently skipped during import
  • Git submodules not cloned — submodule directories appear empty because submodules require separate initialization
  • Symlinks not resolved — symbolic links in the repository are not followed during import
  • LFS files not downloaded — files tracked by Git LFS are not pulled during the import

How to Fix It

  1. Check .gitignore — review the .gitignore file to understand which files were excluded, then create them manually in Replit
  2. Create missing .env file — add environment variables to Replit Secrets and create a .env file if your app reads from one
  3. Run npm install or pip install — dependency directories like node_modules are in .gitignore and must be reinstalled
  4. Initialize submodules manually — use the Shell to run git submodule init && git submodule update
  5. Download LFS files — install git-lfs and run git lfs pull in the Replit shell
  6. Compare with GitHub — view the repository on GitHub and manually verify which files are missing in your Replit project

Real developers can help you.

ISHANTDEEP SINGH ISHANTDEEP SINGH Senior Software Engineer with 7+ years of experience in React, JavaScript, TypeScript, Next.js, and Node.js. I’ve also worked as a tech lead for startups, owning end-to-end technical execution including architecture, development, scaling, and delivery. I bring a strong mix of hands-on coding, product thinking, and technical leadership, and I’m comfortable building products from scratch as well as improving and scaling existing systems. Sage Fulcher Sage Fulcher Hey I'm Sage! Im a Boston area software engineer who grew up in South Florida. Ive worked at a ton of cool places like a telehealth kidney care startup that took part in a billion dollar merger (Cricket health/Interwell health), a boutique design agency where I got to work on a ton of exciting startups including a photography education app, a collegiate Esports league and more (Philosophie), a data analytics as a service startup in Cambridge (MA) as well as at Phillips and MIT Lincoln Lab where I designed and developed novel network security visualizations and analytics. I've been writing code and furiously devoted to using computers to make people’s lives easier for about 17 years. My degree is in making computers make pretty lights and sounds. Outside of work I love hip hop, the Celtics, professional wrestling, magic the gathering, photography, drumming, and guitars (both making and playing them) Bastien Labelle Bastien Labelle Full stack dev w/ 20+ years of experience Yovel Cohen Yovel Cohen I got a lot of experience in building Long-horizon AI Agents in production, Backend apps that scale to millions of users and frontend knowledge as well. Caio Rodrigues Caio Rodrigues I'm a full-stack developer focused on building practical and scalable web applications. My main experience is with **React, TypeScript, and modern frontend architectures**, where I prioritize clean code, component reusability, and maintainable project structures. I have strong experience working with **dynamic forms, state management (Redux / React Hook Form), and complex data-driven interfaces**. I enjoy solving real-world problems by turning ideas into reliable software that companies can actually use in their daily operations. Beyond coding, I care about **software quality and architecture**, following best practices for componentization, code organization, and performance optimization. I'm also comfortable working across the stack when needed, integrating APIs, handling business logic, and helping transform prototypes into production-ready systems. My goal is always to deliver solutions that are **simple, efficient, and genuinely useful for the people using them.** Jen Jacobsen Jen Jacobsen I’m a Full-Stack Developer with over 10 years of experience building modern web and mobile applications. I enjoy working across the full product lifecycle — turning ideas into real, well-built products that are intuitive for users and scalable for businesses. I particularly enjoy building mobile apps, modern web platforms, and solving complex technical problems in a way that keeps systems clean, reliable, and easy to maintain. Matthew Jordan Matthew Jordan I've been working at a large software company named Kainos for 2 years, and mainly specialise in Platform Engineering. I regularly enjoy working on software products outside of work, and I'm a huge fan of game development using Unity. I personally enjoy Python & C# in my spare time, but I also specialise in multiple different platform-related technologies from my day job. Meïr Ankri Meïr Ankri Full-stack developer specializing in React / Next.js / Node.js with 6+ years of experience. I've worked across various sectors including automotive (Reezocar/Société Générale), healthcare (Medical Link SaaS), and e-commerce (Glasman). I build web apps end-to-end, from architecture to production, with a focus on scalability, performance, and code quality. I also mentor junior developers and contribute to technical decisions and code reviews. Basel Issmail Basel Issmail ’m a Senior Full-Stack Developer and Tech Lead with experience designing and building scalable web platforms. I work across the full development lifecycle, from translating business requirements into technical architecture to delivering reliable production systems. My work focuses on modern web technologies, including TypeScript, Angular, Node.js, and cloud-based architectures. I enjoy solving complex technical problems and helping teams turn product ideas and prototypes into working platforms that can grow and scale. In addition to development, I often collaborate closely with product managers, business analysts, designers, and QA teams to ensure that solutions align with both technical and business goals. I enjoy working with startups and product teams where I can contribute both as a hands-on engineer and as a technical partner in designing and delivering impactful software. Nam Tran Nam Tran 10 years as fullstack developer

You don't need to be technical. Just describe what's wrong and a verified developer will handle the rest.

Get Help

Frequently Asked Questions

Why are some files missing after importing from GitHub?

Files listed in .gitignore (like .env, node_modules, build folders) are not tracked by Git and therefore not imported. You need to create these files manually or run install commands in Replit.

My app needs a .env file but it was not imported. What do I do?

Create the required environment variables in Replit's Secrets panel. If your app reads from a .env file directly, create one manually with the required variables.

Can I pull updates from GitHub after the initial import?

Yes, use the Git panel in Replit or run git pull in the Shell to sync with the latest changes from GitHub.

Related Replit Issues

Can't fix it yourself?
Real developers can help.

You don't need to be technical. Just describe what's wrong and a verified developer will handle the rest.

Get Help