Skip to content

fjcoira/status-page-view

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Status Page View – Forge App for Confluence Cloud

Status Page View is a Confluence Cloud Forge app that allows users to generate live, customizable reports of pages using CQL queries.
It displays a dynamic table with metadata like title, author, creation and update dates, and most importantly — the content status (e.g., Rough draft, Published, Archived), which isn’t available in native Confluence search.

Built for the Forge Quest: Bonus Level hackathon.


✨ Features

  • 🔎 Search Confluence content using custom CQL queries
  • 📄 Display title, author, creation and update dates
  • 🟢 Show the actual status of each page with a colored Lozenge
  • 🧩 Filter results by author or space
  • 📊 Sort by any column in the table
  • 📥 Export results to CSV
  • ⚡ Backend caching and concurrency-limited API usage to reduce load

🛠 Built with

  • Atlassian Forge
  • Confluence Cloud
  • Forge UI Kit 2
  • React (Custom UI)
  • Node.js (resolvers)
  • @forge/bridge, @forge/api, @forge/storage
  • Confluence REST API (v1 and v2)

🚀 Getting started

# Install dependencies
npm install

# Deploy the app
forge deploy

# Install the app to your Confluence site
forge install

# Run locally with hot reload
forge tunnel

You’ll need the Forge CLI set up beforehand.


📁 Project structure

src/
├── frontend/
│   ├── components/
│   │   ├── ConfluencePageTable.jsx
│   │   └── UiKitDynamicTable.jsx
│   ├── utils/
│   │   ├── exportCsv.js
│   │   └── statusMapper.js
│   ├── config.jsx
│   └── index.jsx
├── resolvers/
│   ├── cache.js
│   ├── searchPages.js
│   ├── validateCql.js
│   └── index.js
manifest.yml

🧠 Notes

  • Each page’s contentState is fetched individually using /content/{id}/state, with results cached for 5 minutes using @forge/storage.
  • Sorting is fully supported via UI Kit 2’s DynamicTable, using the key prop for raw data.
  • The app balances performance with accuracy using a concurrency-limited fetch pool for state resolution.

📸 Screenshot

Status Page View in action


📜 License

MIT


Built with ❤️ and caffeine for Forge Quest.

About

Forge app to display Confluence page status using CQL queries

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published