Skip to main content

First Run

Now that you've installed LibreApps Desktop, let's launch the development server and explore the dashboard.

Starting the Development Server​

From within the build/web/full-kit directory, run:

pnpm dev

The server will start, typically on http://localhost:3000.

What's Happening?​

  • Turbopack: Next.js uses Turbopack for lightning-fast incremental builds.
  • Watch Mode: Changes you make to files will instantly reflect in the browser.
  • I18n Detection: The app will automatically detect your browser language and redirect you (e.g., to /en/).

Logging In​

When you first visit the dashboard, you will be redirected to the Sign In page.

Default Credentials​

For local development with the default .env settings, you can use:

  • Username: admin@example.com
  • Password: password123

💡 Tip: In production, these should be handled by Keycloak or your chosen OAuth provider.

Exploring the Dashboard​

Once logged in, take a moment to explore:

  1. Sidebar: Navigate between the Analytics dashboard and the built-in apps (Email, Chat, Kanban).
  2. Theme Customizer: Click the "Customizer" icon (usually a paint palette) to change colors, radius, and layout mode in real-time.
  3. AI Chat: Look for the chat icon in the right sidebar to see the Smash AI Chat widget in action.
  4. Theme Gallery: Visit /en/themes/gallery to see how different brand identities look instantly.

Verification Checklist​

Confirm your installation is successful by checking:

  • The page loads without 404 or 500 errors.
  • You can log in using the credentials above.
  • The charts on the Analytics page render data.
  • Switching between Light and Dark mode works correctly.

Everything working? Project Structure →