🚀 VercelZero

Open-source deployment platform inspired by the original Vercel experience

A portfolio-grade project focused on product UX, frontend architecture, and AI-assisted workflows.

🌐 Live Demo · ⚡ Quick Start · 🤝 Contributing

---

📌 About the Project

VercelZero is a modern, educational recreation of a deployment platform experience. It was designed to demonstrate real-world engineering skills in:

• Product-oriented frontend development.
• Component-driven architecture with scalability in mind.
• AI-enhanced user interactions.
• Open-source collaboration and maintainability.

This repository is intentionally positioned to be attractive for:

• International recruiters evaluating technical depth + product thinking.
• Contributors looking for a clean and approachable codebase.
• Developers learning how modern SaaS-like interfaces are structured.

---

✨ Features

• 🔄 Simulated deployment flow for frontend projects.
• 🌐 Preview-oriented interface inspired by production platforms.
• 📊 Dashboard-centric experience for project visibility.
• 🤖 AI-assisted interactions powered by CopilotKit/OpenAI.
• 📱 Responsive design for desktop and mobile.

---

🧰 Tech Stack

• Next.js 14
• TypeScript
• React 18
• Tailwind CSS
• CopilotKit
• OpenAI

---

📸 Screenshots

---

⚡ Quick Start

1) Clone the repository

git clone https://github.com/DaveSimoes/VercelZero.git
cd VercelZero

2) Install dependencies

npm install

3) Start development server

npm run dev

Open http://localhost:3000.

---

🔐 Environment Variables Create a .env.local file in the project root.

Variable Description Required OPENAI_API_KEY API key used by OpenAI-powered features Yes Add any extra environment variables required by your deployment/auth setup.

🧪 Scripts

npm run dev        # start development server
npm run build      # create production build
npm run start      # run production server
npm run lint       # run ESLint checks
npm run typecheck  # run TypeScript checks

---

🗺️ Roadmap

• Add CI gates for lint + typecheck on pull requests.

• Expand automated tests for critical flows.

• Add end-to-end tests for deployment simulation.

• Publish architecture diagrams and deeper docs.

• Add localization support (EN/PT-BR).

---

🤝 Contributing Contributions are welcome and appreciated.

• Read the Contributing Guide.

• Follow the Code of Conduct.

• Use issue and PR templates available in .github/.

If you want to help quickly, start with documentation improvements, UI polish, and tests.

---

🌟 Support If you find this project useful:

• ⭐ Star the repository.

• 🐛 Open high-quality issues.

• 🔀 Submit focused pull requests.

• 📣 Share it with your network.

• 📄 License This project is licensed under the MIT License.

Built with ❤️ by Dave Simões