Pinboard — PHP App Scaffold

Starter scaffold for the PHP App Track of the Nextcloud Developer Course.

What this is

This repo contains the directory structure and stub files you'll fill in as you work through the Beginner modules. No business logic is included — the course guides you through building it from scratch.

Getting started

1. Fork this repo on GitHub
2. Clone your fork into your Nextcloud apps directory:

   git clone https://github.com/YOUR_USERNAME/pinboard-php workspace/server/apps-extra/pinboard

3. Follow the course starting from Module 2 — App Anatomy

If you have not set up a development environment yet, start with Setting Up Your Development Environment.

Structure

pinboard/
├── appinfo/
│   ├── info.xml          ← app manifest (stub → filled in Module 2)
│   └── routes.php        ← route definitions (stub → filled in Module 2)
├── img/
│   └── app.svg           ← navigation icon (white fill)
├── lib/
│   ├── AppInfo/
│   │   └── Application.php   ← bootstrap class (stub → filled in Module 2)
│   ├── Controller/           ← filled in Module 3
│   ├── Db/                   ← filled in Module 4
│   └── Service/              ← filled in Module 4
├── templates/                ← filled in Module 3
├── js/                       ← compiled frontend (Module 5+)
└── css/                      ← compiled styles (Module 5+)

Requirements

• Nextcloud 34
• PHP 8.3+
• nextcloud-docker-dev (set up in Module 1)

Licence

AGPL-3.0-or-later, the same licence as Nextcloud itself.