Getting Started

This guide walks you through registering your company on PinkApple ERP, logging in for the first time, and navigating the dashboard.

Step 1: Register Your Company

1. Visit the PinkApple landing page at https://pinkapple-erp.com
2. Click Get Started or navigate to /register-company
3. Fill in the registration form:

Field	Description
Company Name	Your organisation's legal or trading name (e.g., "Acme Financial Services")
Owner's Full Name	The name of the primary administrator
Company Email	The email address where login credentials will be sent
Phone Number	Contact phone number with country code
Country	Select your country of operation

4. Click Register Company

What Happens Next

After you submit the form, PinkApple automatically provisions your company environment:

1. Database creation — A dedicated, isolated database is created for your company
2. Schema migration — All required tables, procedures, and configurations are set up
3. Default configuration — A default service, business unit type, head office business unit, admin role, and fiscal calendar are created
4. Credentials email — Your login credentials are sent to the company email you provided

You can track the setup progress in real time on the registration page. The process typically completes in under two minutes.

TIP

Save the setup tracking URL from your email. If the page closes, you can use it to check the status of your company provisioning.

Step 2: First Login

1. Navigate to https://app.pinkapple-erp.com/c/{your-company-alias}/auth/login
   • Your company alias is a URL-friendly version of your company name (e.g., acme-financial-services). It's included in the credentials email.
2. Enter the email and temporary password from the credentials email
3. You will be prompted to set a new password on first login

Two-Factor Authentication (OTP)

If your company has two-factor authentication enabled, you'll be redirected to the OTP verification page after entering your credentials. Enter the code sent to your email or phone.

Service Context Selection

If your company has multiple services configured, you'll see a Context Selection page after login. Choose the service context you want to work in (e.g., "Banking & Finance" or "Community Finance & HR"). This determines which modules and data you see in the sidebar.

INFO

You can switch between services at any time using the Service Switcher in the sidebar. See Navigation & Permissions for details.

Step 3: The Dashboard

After login, you land on the General Dashboard. The dashboard provides an overview of key metrics depending on your role:

• General Dashboard — High-level organisational metrics, approval items pending your action, and recent activity
• Teller Dashboard — Available for teller roles, showing till balances, today's transactions, and cash position
• Loan Officer Dashboard — Available for loan officers, showing portfolio summary, pending applications, and arrears

Approval Items

The dashboard includes an Approval Items section showing records awaiting your approval across all modules — GL journals, loan applications, transactions, etc. Click any item to review and approve or reject it.

Step 4: Initial Setup

After your first login, you'll want to configure the foundational settings for your company. Follow these guides in order:

1. Organisation Details — Set timezone, language, base currency, date format
2. Business Units & Types — Define your branch/department hierarchy
3. Users & Roles — Create user accounts and assign roles
4. Currency Setup — Activate the currencies you operate in
5. Calendar & Fiscal Periods — Set up your fiscal year and periods
6. Chart of Accounts — Build your GL account hierarchy
7. GL Posting Rules — Define how transactions post to the GL

WARNING

The order matters. Business units must exist before you can create users assigned to them. Fiscal periods must exist before you can post journal entries. The chart of accounts must exist before you can configure GL posting rules.

URL Structure

PinkApple uses a subdomain-based architecture:

Domain	Purpose
pinkapple-erp.com	Landing page, company registration
app.pinkapple-erp.com	Main application (tenant app)
docs.pinkapple-erp.com	This documentation

Within the app, routes follow the pattern:

https://app.pinkapple-erp.com/c/{company-alias}/{module}/{section}/{page}

For example:

https://app.pinkapple-erp.com/c/acme/administration/accounting/chart_of_account