Skip to content

Showcase all the great demos and resources that your peers are working on.

Notifications You must be signed in to change notification settings

octo-faq/enterprise-showcase

 
 

Repository files navigation

enterprise-showcase

Showcase all the great work that your peers are working on and happily sharing internally.

enterprise-showcase is a static web site, hosted on GitHub Pages and generated through GitHub Actions. No need for a separate runtime or server, and you can fine tune how often you want the site to be generated.

Features

  • Browse every internal repository across all organizations of your GitHub Enterpise Account.
  • Create collections of repositories so that you can highlight great projects.
  • Easily extended so you can customize it to your needs

enterprise-showcase is built with GitHub Pages, GitHub Actions, Nuxt.js and Vuetify

Setup

Screenshot 2021-05-19 at 10 47 05

  • Enable GitHub Pages by setting gh-pages as the source branch Screen Shot 2021-01-11 at 16 16 46
  • Create a GH_EA_TOKEN secret and provide a Personal Access Token with read:org and read:enterprise permissions as the value (see helaili/ea-repo-list for more details).
  • Configure the repository retrieval job by editing the .github\workflows\repo-list.yml and provide the name of your GitHub Enterprise Account
    steps:
    - uses: actions/checkout@v2
    - name: Get the repos
      uses: helaili/ea-repo-list@master
      with:
        enterprise: <replace with GitHub Enteprise Account name>
        outputFilename: repositories.json
        token: ${{secrets.GH_EA_TOKEN}}
  • Manually trigger a first repository list retrieval by starting the Generate repository list workflow. The Actions workflow should execute succesfully and you should get a freshly commited repositories.json file at the root of your repository. Screen Shot 2021-01-11 at 17 03 17
  • Create collections by creating a .md file per collection in content/collections. The front matter header allow you to set the collection title, description and list of repositories. The body of the document is available to provide a more detailed description of the collection.
---
title: C.R.E.A.M.
description: Cheese Rules Everything Around Me
repositories:
- octocheese/camembert
- octocheese/roquefort
- amsterdam/gouda
- vermont/cheddar
---

# All of them!!! 

We love them all 

Screen Shot 2021-01-11 at 21 49 45

  • The web site should be published to https://<your org or account name>/enterprise-showcase/. In case you renamed the repository, change router.base accordingly in the nuxt.config.js file. Remove this variable completely if you are publishing to your organization or account-level site (<user>.github.io or <organization>.github.io)

Build Setup

# install dependencies
$ npm install

# serve with hot reload at localhost:3000
$ npm run dev

# build for production and launch server
$ npm run build
$ npm run start

# generate static project
$ npm run generate

For detailed explanation on how things work, check out Nuxt.js docs.

Languages

  • Vue 77.5%
  • JavaScript 17.5%
  • SCSS 5.0%