A specialized coding interview environment designed for structured technical assessments.

If you've received this link for a technical interview, follow these steps to set up your environment:

1. Prerequisites

   • Node.js (v14 or higher) - Download here
   • npm (v6 or higher) - comes with Node.js

2. Installation

   # Clone or extract the project to your local machine
   # Open a terminal in the project directory
   
   # Install dependencies (this may take a minute)
   npm install
   
   # Start the development server
   npm start

3. Access the Interview Environment

   • Once started, open your browser to: http://localhost:8080
   • You should see the Codeflow interface ready for your interview

Your interviewer will provide you with a .zip file containing the coding challenge:

1. Extract the pattern's .zip file to your computer
2. Drag and drop the extracted folder into the src/interviews directory
3. The challenge will automatically appear in the interface
4. Click on the pattern to begin coding

• Clean Design - Focus on your code without distractions
• Instructions - Access requirements and tips anytime
• Responsive - Works great on any screen size

1. Review the requirements in the Instructions panel
2. Implement your solution in the provided React component
3. Test your work as you go
4. Ask questions if you need clarification

• Read all instructions carefully before starting
• Ask questions if requirements are unclear
• Focus on clean, readable code over complex solutions
• Test your implementation as you build
• Think about user experience and edge cases

Good luck with your interview! 🚀

Welcome to Codeflow! This is an open-source shell for conducting structured technical interviews where candidates can code in their own environemnt, and use the AI tools they prefer.

Codeflow is a React-based interview platform that provides:

• A clean, distraction-free coding environment
• Support for multiple interview patterns and challenges
• Extensible architecture for custom interview formats

codeflow/
├── src/
│   ├── components/       # UI components
│   ├── interviews/      # Interview patterns & challenges. This directory should NOT contain interviews at the repository level.
│   ├── hooks/          # Custom React hooks
│   ├── lib/            # Utility functions
│   └── server/         # Mock API server (SW-based request interception)
├── public/             # Static assets
└── package.json        # Dependencies

# Clone the repository
git clone [email protected]:webflow/codeflow.git
cd codeflow

# Install dependencies
npm install

# Start development server
npm start

# Build for production
npm run build

Interview patterns are modular challenges that can be loaded dynamically. See src/interviews/README.md for detailed pattern creation guidelines.

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

• Interview Pattern Documentation
• Contributing Guidelines

For issues or questions:

• Candidates: Contact your interviewer or recruiting team
• Contributors: Open an issue on GitHub or check existing discussions