bymilon/peoplebase-directory

PeopleBase Directory is a ready-to-use starting point for building an internal people operations dashboard. It gives you a working web application with a sidebar, charts, and a layout designed for HR, payroll, employee, and reporting screens. You clone it, run two commands, and a local development server starts up with the whole dashboard visible in your browser. The project is a front-end only application. There is no database, no authentication system, and no back-end server included. All the data currently shown in charts and cards is static placeholder content. The idea is that you connect it to your own data source later, once you have decided how your product works. The tech choices are all familiar and widely used. React handles the interface, TypeScript adds type checking to catch errors early, Vite makes the local development server fast, Tailwind CSS controls the styling through small utility classes, and Recharts draws the bar charts and funnel visualizations. Adding a new chart means creating a component and dropping it into the dashboard file, adding a new menu item means extending one array in the main app file. One design goal that stands out is support for AI-assisted development. The repository includes a .wiki folder and a DESIGN.md file that document conventions, color choices, and structural decisions. When you ask an AI coding tool to make a change, it can read those files to understand what patterns already exist rather than inventing something inconsistent. There is also a .prompts folder with reusable instructions for common agent workflows. The project is described as a scaffold or starter, not a finished product. It does not include a license file yet, which the roadmap notes as a pending task before public open-source release. If you need a front-end base for an HR or people operations tool that is clean, component-organized, and easy to adapt with or without AI help, this is what this repository offers.