# Campus One Developer Portal (/docs)



Campus One is the central identity platform for Nile University. It lets students sign in once and access every connected campus app — no separate accounts needed.

As a developer, you can register your app, obtain SSO credentials, and use Campus One as your identity provider in minutes.

## What you get [#what-you-get]

* **Single sign-on** — students authenticate with their Campus One account; your app receives a verified identity token over **OpenID Connect** (SAML 2.0 and OAuth 2.0 are planned)
* **Rich user attributes** — access name, email, student ID, study level, faculty, and department (with student consent)
* **Push to the student shell** — send in-app [notifications](/docs/notifications) and [calendar events](/docs/events) straight to a consenting student's dashboard
* **Webhooks** — receive real-time events for profile and role changes, sign-in/out, and account lifecycle
* **Custom roles & external access** — assign app-specific roles and open your app to non-Nile users
* **Shared UI library** — install our shadcn components, theme, and fonts into your own project
* **AI-ready docs** — `llms.txt` endpoints and ready-made prompts so ChatGPT, Claude, Cursor, and IDE copilots integrate accurately
* **Developer dashboard** — manage credentials, monitor sign-in health, and update permissions from one place

## Getting started [#getting-started]

<Cards>
  <Card title="Quickstart" href="/docs/quickstart" description="Connect an app and sign in a test user in a few minutes" />

  <Card title="SSO Overview" href="/docs/sso" description="Understand the sign-in flow and token lifecycle" />

  <Card title="OpenID Connect" href="/docs/sso/oidc" description="Set up OIDC — the live protocol for all new apps" />

  <Card title="Permissions" href="/docs/permissions" description="See what data each scope returns and how to request it" />

  <Card title="App API" href="/docs/app-api" description="Push notifications and calendar events to students via REST" />

  <Card title="Notifications" href="/docs/notifications" description="Send real-time in-app notifications to consenting users" />

  <Card title="Events" href="/docs/events" description="Push calendar events into the student dashboard" />

  <Card title="Webhooks" href="/docs/webhooks" description="Receive real-time events from Campus One" />

  <Card title="External Access & Roles" href="/docs/external-access" description="Open your app to external users and use custom roles" />

  <Card title="Troubleshooting" href="/docs/troubleshooting" description="Fix common OIDC, API, and webhook errors fast" />

  <Card title="Design System" href="/docs/design-system" description="Use our shadcn components, theme, and fonts in your own app" />

  <Card title="AI Integration" href="/docs/ai-integration" description="Feed these docs to ChatGPT, Claude, Cursor, or any agent via llms.txt" />
</Cards>

## Onboarding flow [#onboarding-flow]

1. An admin invites you as a developer — you receive a link to set your password
2. Log in to the Campus One developer dashboard at `/developer/apps`
3. Click **Connect app** and follow the wizard (choose protocol → add branding → enter endpoints → set permissions)
4. Copy your **Client ID** and **Client Secret** (OIDC/OAuth 2.0) or download the **IdP metadata** (SAML)
5. Configure your app with these credentials and point it at the Campus One endpoints
6. Test a sign-in — the student is redirected back to your app with a verified token

## Support [#support]

Contact the Campus One platform team or open a ticket through the admin console.