Internal Apps Timeline Dashboard

A dashboard for teams to track project timelines, milestones, FAT/SAT schedules, and upcoming work across projects followed from ClickUp. ClickUp can be difficult to use, so the goal with this dashboard is to only track projects relevant to your team.

Table of contents

• Features
• Local setup
• Running the application

Features

Calendar & Timeline Views

• Month, Week, and Timeline (Gantt) views
• Key dates per project: Design, Method development & testing, FAT, Site Build / Install, and SAT
• Filter calendar by Internal Apps team member
• Team time-off overlay for scheduling

Dashboard overview

• All Projects / My Projects toggle (filter to projects you are assigned on in ClickUp)
• Upcoming milestones in the next 7 / 14 / 30 days
• FAT and SAT schedule visibility
• Blocked projects requiring attention
• Last synced timestamp from ClickUp

Projects overview

• Projects grouped by Internal Apps team member
• Import projects from ClickUp (Discover or Import by URL)
• Filter by phase badge (Design, FAT, Site Build, etc.)

Local setup

Prerequisites

• Git — to clone the repository (https://git-scm.com/download/win)
• Node.js 18+ and npm — nodejs.org or your system package manager

Verify installation:

node -v
npm -v

1. Clone the repository

Open Git Bash and run:

git clone https://github.com/beckywong37/internal-apps-dashboard.git
cd internal-apps-dashboard

2. Install dependencies

npm install

3. Create a ClickUp API Token

• Go to Settings in ClickUp
• Select ClickUp API and click Generate and Copy
  • The token will look similar to: pk_xxxxxxxxxxxxxxxxxxxxxxxxx

4. Create a local environment file

Rename .env.example to .env and update the following value (line 6) with your token:

VITE_CLICKUP_TOKEN=pk_xxxxxxxxxxxxxxxxxxxxxxxxx

Optional:

VITE_CLICKUP_TEAM_ID=xxxxxxxx
VITE_IAS_MEMBER=Becky Wong

Never commit your .env file to GitHub.

Running the application

1. Start the local development server

npm run dev

2. Open the application in your browser

http://localhost:5173 or whichever port is open

npm run dev -- --port 5176

Other commands:

Command	Purpose
npm run build	Type-check and production build
npm run preview	Preview the production build locally
npm run lint	TypeScript check (tsc --noEmit)

The ClickUp proxy only runs with npm run dev. A static host of dist/ needs a similar backend proxy in production.