Added project readme
This commit is contained in:
BIN
media/Screen Shot 2025-10-24 at 19.06.12-fullpage.png
Normal file
BIN
media/Screen Shot 2025-10-24 at 19.06.12-fullpage.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 88 KiB |
BIN
media/Screen Shot 2025-10-24 at 19.11.06-fullpage.png
Normal file
BIN
media/Screen Shot 2025-10-24 at 19.11.06-fullpage.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 60 KiB |
BIN
media/Screen Shot 2025-10-24 at 19.18.46-fullpage.png
Normal file
BIN
media/Screen Shot 2025-10-24 at 19.18.46-fullpage.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 89 KiB |
BIN
media/Screen Shot 2025-10-24 at 19.21.03-fullpage.png
Normal file
BIN
media/Screen Shot 2025-10-24 at 19.21.03-fullpage.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 95 KiB |
90
readme.md
Normal file
90
readme.md
Normal file
@@ -0,0 +1,90 @@
|
|||||||
|
# Kiosk
|
||||||
|
|
||||||
|
A modern office/building information display system built with React and PocketBase. Provides an interactive interface for building navigation, company directory, and bulletin notices.
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
- **Interactive Floor Plans** - Navigate multi-story buildings with annex filtering, room highlighting, and company logo positioning
|
||||||
|
- **Company Directory** - Browse tenant companies with contact information and visual cards
|
||||||
|
- **Bulletin Board** - Display important notices and announcements
|
||||||
|
- **Static Hosting Ready** - Hash-based routing for deployment anywhere
|
||||||
|
|
||||||
|
## Screenshots
|
||||||
|
|
||||||
|
### Bulletin Board
|
||||||
|

|
||||||
|
|
||||||
|
### Company Directory
|
||||||
|

|
||||||
|
|
||||||
|
### Floor Plan Navigation
|
||||||
|

|
||||||
|
|
||||||
|
### About Page
|
||||||
|

|
||||||
|
|
||||||
|
## Setup
|
||||||
|
|
||||||
|
### Prerequisites
|
||||||
|
|
||||||
|
- **pnpm** 8+ (package manager)
|
||||||
|
- **PocketBase** (backend database)
|
||||||
|
|
||||||
|
### PocketBase Setup
|
||||||
|
|
||||||
|
1. Download PocketBase from [pocketbase.io](https://pocketbase.io)
|
||||||
|
2. Initialize the database:
|
||||||
|
```bash
|
||||||
|
./pocketbase serve
|
||||||
|
```
|
||||||
|
3. Import the schema from `schema/pb_schema.json` via the PocketBase admin UI (_Settings > Import collections_)
|
||||||
|
|
||||||
|
### Web Frontend
|
||||||
|
|
||||||
|
Install dependencies:
|
||||||
|
```bash
|
||||||
|
cd web
|
||||||
|
pnpm install
|
||||||
|
```
|
||||||
|
|
||||||
|
#### Development Mode
|
||||||
|
|
||||||
|
Run the development server:
|
||||||
|
```bash
|
||||||
|
make web-dev
|
||||||
|
# or
|
||||||
|
cd web && pnpm dev
|
||||||
|
```
|
||||||
|
|
||||||
|
The app will be available at `http://localhost:5173`
|
||||||
|
|
||||||
|
#### Production Build
|
||||||
|
|
||||||
|
Build for production:
|
||||||
|
```bash
|
||||||
|
make web-build
|
||||||
|
# or
|
||||||
|
cd web && pnpm build
|
||||||
|
```
|
||||||
|
|
||||||
|
Built files will be in `web/dist/` - ready for static hosting.
|
||||||
|
|
||||||
|
### Additional Commands
|
||||||
|
|
||||||
|
```bash
|
||||||
|
make web-lint # Run ESLint
|
||||||
|
make web-format # Format code with Prettier
|
||||||
|
make web-preview # Preview production build
|
||||||
|
```
|
||||||
|
|
||||||
|
## Tech Stack
|
||||||
|
|
||||||
|
- **Frontend**: React 19, TypeScript, Vite, Tailwind CSS
|
||||||
|
- **UI Components**: shadcn/ui
|
||||||
|
- **Routing**: Wouter (hash-based)
|
||||||
|
- **Backend**: PocketBase
|
||||||
|
- **Build**: Vite with Rolldown (beta)
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
MIT License - Copyright © 2025 "NABLA" d.o.o. Zenica
|
||||||
Reference in New Issue
Block a user