> ## Documentation Index
> Fetch the complete documentation index at: https://dos.dzaleka.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction to Dzaleka Online Services

> Your digital gateway to Dzaleka Refugee Camp services, cultural heritage, and community connections

# Introduction to Dzaleka Online Services

Dzaleka Online Services is a comprehensive digital platform serving Malawi's largest refugee community in Dzaleka Refugee Camp. The platform provides centralized access to essential services, cultural heritage preservation, community resources, and opportunities for over 60,000 residents.

## Mission & Vision

### Our Mission

To empower the Dzaleka community by:

* **Connecting people** to essential services, resources, and opportunities
* **Preserving cultural heritage** through digital archiving and storytelling
* **Amplifying community voices** through participatory platforms
* **Bridging digital divides** by providing accessible online services

### Our Vision

A thriving, digitally-connected refugee community where every resident has access to information, services, and opportunities to build sustainable futures.

## Key Features

<CardGroup cols={2}>
  <Card icon="building" title="Services Directory">
    Comprehensive directory of healthcare, education, legal aid, and community services with contact information, locations, and hours.
  </Card>

  <Card icon="briefcase" title="Job Board">
    Employment opportunities including full-time, part-time, contract, volunteer, and internship positions across multiple sectors.
  </Card>

  <Card icon="calendar" title="Events Platform">
    Community events, cultural celebrations, workshops, and educational programs with registration and panelist information.
  </Card>

  <Card icon="shopping-cart" title="Digital Marketplace">
    Buy and sell products, discover local restaurants and shops, and access services from community vendors.
  </Card>

  <Card icon="book" title="Resource Library">
    Essential guides, reports, research documents, and educational materials in multiple languages.
  </Card>

  <Card icon="landmark" title="Cultural Heritage">
    Photo galleries, artist profiles, site registers, public art catalogues, and community stories preserving Dzaleka's rich culture.
  </Card>
</CardGroup>

## Platform Highlights

### Community-Driven Content

Dzaleka Online Services is built by and for the community. Residents can:

* Submit service suggestions
* Share community stories and voices
* Report issues and provide feedback
* Contribute to photo galleries and cultural archives
* List products and services in the marketplace

### Multilingual Support

Resources and content are available in multiple languages to serve Dzaleka's diverse international community.

### Mobile-First Design

The platform is optimized for mobile devices, ensuring accessibility for users accessing services via smartphones.

### Real-Time Search

Powerful search functionality helps users quickly find:

* Organizations and services
* Events and opportunities
* Resources and documents
* Community members and talent

## What's Included

<Steps>
  <Step title="Find Services">
    Browse healthcare, education, legal aid, business services, and more. Filter by category, view locations on interactive maps, and access contact information.
  </Step>

  <Step title="Discover Opportunities">
    Explore job postings, volunteer positions, educational courses, and skills exchange programs.
  </Step>

  <Step title="Engage with Culture">
    View photo galleries, read community stories, discover artists, dancers, and poets, and explore Dzaleka's public art.
  </Step>

  <Step title="Access Resources">
    Download guides, reports, and educational materials. Access research and documentation about refugee rights and services.
  </Step>

  <Step title="Connect with Community">
    Participate in events, join discussions, share your voice, and contribute to the digital heritage archive.
  </Step>
</Steps>

## Technology Stack

Dzaleka Online Services is built with modern web technologies:

* **Framework**: Astro 5.x for static site generation
* **Styling**: Tailwind CSS with custom design system
* **Interactivity**: React components and Alpine.js
* **Content**: MDX and structured content collections
* **Deployment**: Netlify with serverless functions
* **Search**: MiniSearch for client-side search
* **Forms**: Formspree and Resend for contact forms

<Note>
  The platform uses a content-first architecture that makes it easy for non-technical community members to contribute content through simple markdown files.
</Note>

## Content Collections

The platform manages 20+ content collections:

| Collection      | Description                                         | Count |
| --------------- | --------------------------------------------------- | ----- |
| **Services**    | Healthcare, education, legal, business services     | 100+  |
| **Events**      | Community events, workshops, celebrations           | 50+   |
| **Jobs**        | Employment and volunteer opportunities              | 30+   |
| **Resources**   | Guides, reports, research documents                 | 75+   |
| **News**        | Announcements, business spotlights, success stories | 40+   |
| **Photos**      | Community photography and galleries                 | 200+  |
| **Stories**     | Community narratives and experiences                | 25+   |
| **Artists**     | Profiles of visual artists                          | 15+   |
| **Dancers**     | Dance groups and performers                         | 10+   |
| **Poets**       | Literary artists and spoken word performers         | 12+   |
| **Marketplace** | Products and services for sale                      | 50+   |
| **Stores**      | Restaurants, cafes, shops                           | 20+   |

## API Access

Dzaleka Online Services provides RESTful API endpoints for programmatic access:

```javascript theme={null}
// Example: Fetch all events
fetch('https://services.dzaleka.com/api/events')
  .then(response => response.json())
  .then(data => console.log(data));
```

Available endpoints include:

* `/api/services` - Service directory
* `/api/events` - Events calendar
* `/api/jobs` - Job listings
* `/api/resources` - Resource library
* `/api/news` - News and announcements
* `/api/photos` - Photo gallery
* And more...

<Note>
  API endpoints include rate limiting (60 requests per minute) and CORS support for cross-origin requests.
</Note>

## Community Impact

Since launch, Dzaleka Online Services has:

* **Connected** thousands of residents to essential services
* **Preserved** hundreds of photographs and stories
* **Facilitated** job placements and volunteer opportunities
* **Amplified** community voices through participatory platforms
* **Bridged** information gaps for new arrivals

## Get Involved

There are many ways to contribute:

<CardGroup cols={3}>
  <Card icon="pen" title="Submit Content">
    Share your story, contribute photos, or suggest services
  </Card>

  <Card icon="flag" title="Report Issues">
    Help improve the platform by reporting bugs or outdated information
  </Card>

  <Card icon="users" title="Join the Team">
    Check the job board for opportunities to contribute professionally
  </Card>
</CardGroup>

## Next Steps

<CardGroup cols={2}>
  <Card icon="rocket" href="/quickstart" title="Quickstart Guide">
    Learn how to access and use the platform effectively
  </Card>

  <Card icon="chart-network" href="/platform-overview" title="Platform Overview">
    Understand the technical architecture and features
  </Card>
</CardGroup>

***

*Dzaleka Online Services is a community-driven initiative dedicated to serving and empowering refugees in Dzaleka Camp through digital connectivity and cultural preservation.*