Appê 🏢

A full-stack TypeScript monorepo for a modern condominium management application, built with Bun, Hono, Vite, and React.

About

Appê is a comprehensive solution for managing condominium daily operations. It provides a platform for residents, administration, and staff to interact seamlessly. From booking spaces to managing visitors, Appê aims to modernize and simplify condo living.

Features

• Full-Stack TypeScript: End-to-end type safety between client and server.
• Monorepo Structure: Organized as a workspaces-based monorepo with Turbo for build orchestration.
• User Authentication: Secure login for residents and staff.
• Notice Board: A central place for announcements and important information.
• Document Management: Share and access important documents like meeting minutes or regulations.
• Visitor Control: Pre-authorize and manage guest access.
• Space Bookings: Easily book common areas like party halls or barbecue pits.
• Concierge Chat: Real-time communication with the building's concierge.
• Modern Stack:
  • Bun as the JavaScript runtime and package manager
  • Hono as the backend framework
  • Drizzle ORM for database access
  • Vite for frontend bundling
  • React for the frontend UI
  • shadcn/ui for UI components
  • Turbo for monorepo build orchestration and caching

Project Structure

.
├── client/               # React frontend (Vite)
├── server/               # Hono backend (Node.js/Bun)
├── shared/               # Shared TypeScript definitions
│   └── src/types/        # Type definitions used by both client and server
├── package.json          # Root package.json with workspaces
└── turbo.json            # Turbo configuration for build orchestration

Getting Started

Prerequisites

• Bun

Installation

# Install dependencies for all workspaces
bun install

Development

# Run all workspaces in development mode with Turbo
bun run dev

# Or run individual workspaces directly
bun run dev:client    # Run the Vite dev server for React
bun run dev:server    # Run the Hono backend

Building

# Build all workspaces with Turbo
bun run build

# Or build individual workspaces directly
bun run build:client  # Build the React frontend
bun run build:server  # Build the Hono backend

License

This project is licensed under the MIT License. See the LICENSE file for details.