Nimbus – Local Services Marketplace — complete Crystal marketplace platform example app

Nimbus – Local Services Marketplace is a free, open-source marketplace platform built with Crystal. Nimbus is a server‑rendered directory of local service providers built with Kemal (Crystal). Run it locally, deploy it as a self-hosted marketplace platform, or remix it on cenius.ai to make it your own — the whole application (code, design, seeded demo data) ships in this repository under the Apache-2.0 license.

▶ Open & edit in cenius.ai — one click to an editable workspace: describe changes in plain English, get an instant preview, one-click deploy and host. Modifications made on the platform come with full rebrand & relicense rights.

Local clone? See Quick start below. cenius.ai is the zero-setup path.

Demo

▶ Watch the full demo video — the complete walkthrough, playing on the project's cenius.ai page ·

Screenshots

Features

• Keyword search
• Browse by category
• Listing detail view
• Responsive UI
• Light/dark mode toggle
• Admin listing management
• Multi‑vendor display
• Homepage with featured listings

Quick start

./install.sh   # installs dependencies + seeds demo data

See INSTALL.md for full setup and usage instructions.

Usage guide

Public Pages

Homepage (/)

Shows featured service listings and a browsable category grid. Use the search bar at the top to find services by keyword.

Search (/search?q=keyword)

Type a keyword (e.g. "plumbing", "photography", "tutoring") and press Enter. Results show matching listings with titles and descriptions. An empty search shows a prompt to start searching.

Category Browsing (/categories/:slug)

Each category has its own page listing all services in that category. Categories are accessible from the left sidebar (desktop) or the homepage category grid.

Listing Detail (/listings/:id)

Shows full service details: title, description, price range, vendor name and contact information (email, phone, website).

Theme Toggle

Click the sun/moon icon in the top bar to switch between light and dark mode. Your preference is saved in localStorage and respects your system preference by default.

Admin Panel

Login (/admin/login)

Navigate to /admin/login and sign in with the demo credentials:

• Username: cenius@cenius.ai
• Password: cenius

Manage Listings (/admin/listings)

View, create, edit, and delete service listings. Click + New Listing to add a service. Each row has Edit and Delete buttons.

Full guide: USAGE.md

Architecture

Crystal application, delivered as a complete, runnable project (269 files). Top-level layout: bin/, data/, db/, lib/, public/, src/. install.sh provisions dependencies and seeds demo data, so the app boots with something to show. Setup details live in INSTALL.md.

FAQ

What does it take to self-host Nimbus – Local Services Marketplace?

Everything you need ships in this repo: clone it, run ./install.sh to install dependencies and seed demo data, then follow INSTALL.md to start it. No external services required.

Is white-labeling Nimbus – Local Services Marketplace allowed?

Yes — and the easiest way is remixing it on cenius.ai: modifications made on the platform come with full rebrand and relicense rights over your derivative.

How can I customize Nimbus – Local Services Marketplace without editing code?

Describe what you want changed on cenius.ai — no code editing needed; the platform produces a fresh build you can download and deploy.

What is Nimbus – Local Services Marketplace built with?

Crystal. The full source in this repository is exactly what the app runs. Highlights include admin listing management.

Does the Nimbus – Local Services Marketplace license allow commercial use?

Yes. The code is Apache-2.0-licensed — use it, modify it, and ship it commercially. See LICENSE.

License & rebranding

Released under the Apache License 2.0 (© 2026 Cenius AI) — free for personal and commercial use. The Cenius name/logo are trademarks (see NOTICE).

Need a customized version? Remix this app on cenius.ai — modifications made on the platform come with full rebrand & relicense rights over your derivative.

Built with cenius.ai

This entire application — code, design, seeded demo data — was generated on cenius.ai from a plain-English description.

• 🚀 Build your own app on cenius.ai
• 🎛️ Remix Nimbus – Local Services Marketplace on the marketplace — open it in a workspace, prompt for changes, and ship your own version.

More open-source apps: the Cenius-ai catalog · showcase index