Welcome to the main source of all internal technology for the App Dev Club. The Tech Ops infrastructure housed in this repository is central to all our operations, powering everything from recruitment, finances, event management, and team provisioning to our public-facing web presence.
This project is structured as a modern Nx Monorepo, allowing us to seamlessly manage multiple applications, libraries, and deployments from a single, unified codebase.
This repository contains several distinct applications and services:
The engine behind People Portal. It orchestrates People and Team Management, Recruitment, and Shared Resource Management workflows. It also handles event management, executive permissions, SSO service integrations, team provisioning, and user onboarding. It enforces dynamic permissions via a custom authorization layer called Bindles.
Note
The peopleportal directory contains all People Portal assets, including the UI, server backend, and Docker deployment configurations.
The official App Dev Club landing page, currently hosted at appdevclub.com. It serves as the front door for prospective members, partners, and sponsors. The source code is located in the landing-v3 directory.
The App Dev Wiki, hosted at wiki.appdevclub.com. This is our central knowledge base for internal documentation, guides, and organizational memory. The source code is located in the corpwiki directory.
Scaffolding and initial architecture for the new App Dev Horizon project. The source code is located in the horizon directory.
We rely on GitHub Actions and Nx's powerful task running capabilities to automate our development lifecycle. The available workflows include:
- People Portal Deployment: Automatically builds the multi-architecture Docker image (Frontend + Backend) and pushes it to Docker Hub upon changes to the
peopleportal/directory. - Landing Page Deployment: Builds and deploys the landing page directly to Cloudflare Pages upon changes to
landing-v3/. - Corp Wiki Deployment: Builds and deploys the wiki documentation site to Cloudflare Pages upon changes to the
corpwiki/directory.
Because this is an Nx workspace, you can use the provided ./nx wrapper to execute tasks for any project. For exact commands and setup instructions, please visit the specific component folders and see the instructions there.
# Example commands
./nx build pplsdk-ts
./nx serve pplserver
./nx serve pplui
./nx serve landing-v3