utopia-ui 3.0.0 → 3.0.2

package/README.md

@@ -10,7 +10,7 @@ Utopia UIs mission is to provide open source building blocks to create beautiful
 
 The building blocks are designed to allow different networks and communities to assemble their map and app for their specific needs and purpose.
 
-Utopia Game is the first app made with Utopia UI. It is an attempt to use gamification to get users to take action and make the map even more alive. Check it out at [utopia-game.org](https://utopia-game.org/) or see the code in the [repository](https://github.com/utopia-os/utopia-game)
+Utopia Game is one of the apps made with Utopia UI. It is an attempt to use gamification to get users to take action and make the map even more alive. Check it out at [utopia-game.org](https://utopia-game.org/) or see the code in the [repository](https://github.com/utopia-os/utopia-game)
 
 ## Features
 
@@ -23,44 +23,108 @@ Utopia Game is the first app made with Utopia UI. It is an attempt to use gamifi
 
 ## Getting Started
 
+### Basic Map
+In this tutorial we learn how we create a basic React app with a Map component using [utopia-ui](https://github.com/utopia-os/utopia-ui) library.
 
-install via npm
-```bash
- npm install utopia-ui
+For this tutorial we use Vite to create an empty React app called "utopia-static-map"
+
+```shell
+npm create vite@latest utopia-static-map -- --template react
 ```
 
-## Map Component
-The map shows various Layers (places, events, profiles ...) of Irems at their respective position whith nice and informative Popups.
+We open our new app in the terminal and install the [utopia-ui](https://github.com/utopia-os/utopia-ui) package
 
-Tags, colors and clusters help to retain the overview.
+```shell
+cd utopia-static-map
+npm install utopia-ui
+```
+
+We open our `src/App.jsx` and we replace the content with
 
-use the Map UI Component
 ```jsx
-import { UtopiaMap, Layer} from 'utopia-ui'
+import { UtopiaMap } from "utopia-ui"
+
+function App() {
+  return (
+    <UtopiaMap center={[50.6, 9.5]} zoom={5} height='100dvh' width="100dvw">
+    </UtopiaMap>
+  )
+}
+
+export default App
+
+```
+
+Then we start the development server to check out the result in our browser:
+
+```shell
+npm run dev
+```
 
-    <UtopiaMap zoom={5} height='100dvh' width="100dvw">
+And can open our first map app in the browser 🙂
+
+### Static Layers
+
+Now we add some static layer.
+
+First we put some sample data in a new file called `src/sample-data.js`
+
+```javascript
+export const places = [{
+    "id": 51,
+    "name": "Stadtgemüse",
+    "text": "Stadtgemüse Fulda ist eine Gemüsegärtnerei in Maberzell, die es sich zur Aufgabe gemacht hat, die Stadt und seine Bewohner:innen mit regionalem, frischem und natürlich angebautem Gemüse mittels Gemüsekisten zu versorgen. Es gibt also jede Woche, von Frühjahr bis Herbst, angepasst an die Saison eine Kiste mit schmackhaftem und frischem Gemüse für euch, welche ihr direkt vor Ort abholen könnt. \r\n\r\nhttps://stadtgemuese-fulda.de",
+    "position": { "type": "Point", "coordinates": [9.632435, 50.560342] },
+  },
+  {
+    "id": 166,
+    "name": "Weidendom",
+    "text": "free camping",
+    "position": { "type": "Point", "coordinates": [9.438793, 50.560112] },
+  }];
+  
+  export const events = [
+    {
+      "id": 423,
+      "name": "Hackathon",
+      "text": "still in progress",
+      "position": { "type": "Point", "coordinates": [10.5, 51.62] },
+      "start": "2022-03-25T12:00:00",
+      "end": "2022-05-12T12:00:00",
+    }
+  ]
+```
+
+We want to create two Layers. One we want to call *Places* and the other *Events*
+
+we import our sample data to the `src/App.jsx`
+
+```jsx
+import { events, places } from "./sample-data"
+```
+and than we create our two `<Layer>` inside of our `<UtopiaMap>` component
+```jsx
+    <UtopiaMap center={[50.6, 15.5]} zoom={5} height='100dvh' width="100dvw">
       <Layer
         name='events'
-        menuIcon='CalendarIcon'
-        menuText='add new event'
-        menuColor='#f9a825'
         markerIcon='calendar'
         markerShape='square'
-        markerDefaultColor='#777'
+        markerDefaultColor='#700'
         data={events} />
       <Layer
         name='places'
-        menuIcon='MapPinIcon'
-        menuText='add new place'
-        menuColor='#2E7D32'
         markerIcon='point'
         markerShape='circle'
-        markerDefaultColor='#777'
+        markerDefaultColor='#007'
         data={places} />
     </UtopiaMap>
+
 ```
-You can find some Sample Data (places, events, tags) for test in the `SamleData/` folder
 
+## Map Component
+The map shows various Layers (like places, events, profiles ...) of Items at their respective position whith nice and informative Popup and Profiles.
+
+Tags, colors and clusters help to retain the overview.
 
 
 ### Map Options
@@ -85,3 +149,9 @@ You can find some Sample Data (places, events, tags) for test in the `SamleData/
 *We are looking for Web Developer, UX Designer, Community Manager, Visionaries, Artists, etc. who like to support this Vision.*
 
 [https://t.me/UtopiaMap](https://t.me/UtopiaMap)
+
+## Support us
+
+<a href="https://opencollective.com/utopia-project">
+    <img width="300" src="https://opencollective.com/utopia-project/donate/button@2x.png?color=blue" />
+</a>

package/dist/Components/AppShell/AppShell.d.ts

@@ -1,6 +1,5 @@
 import * as React from 'react';
 import { AssetsApi } from '../../types';
-import 'react-toastify/dist/ReactToastify.css';
 export declare function AppShell({ appName, children, assetsApi, userType }: {
     appName: string;
     children: React.ReactNode;

package/dist/Components/Map/UtopiaMap.d.ts

@@ -1,3 +1,4 @@
 import { UtopiaMapProps } from "../../types";
+import 'react-toastify/dist/ReactToastify.css';
 declare function UtopiaMap(props: UtopiaMapProps): import("react/jsx-runtime").JSX.Element;
 export { UtopiaMap };

package/dist/Components/Map/UtopiaMapInner.d.ts

@@ -1,4 +1,4 @@
 import "leaflet/dist/leaflet.css";
 import { UtopiaMapProps } from "../../types";
 import "./UtopiaMap.css";
-export declare function UtopiaMapInner({ height, width, center, zoom, children, geo, showFilterControl, showGratitudeControl, showLayerControl }: UtopiaMapProps): import("react/jsx-runtime").JSX.Element;
+export declare function UtopiaMapInner({ height, width, center, zoom, children, geo, showFilterControl, showGratitudeControl, showLayerControl, infoText }: UtopiaMapProps): import("react/jsx-runtime").JSX.Element;

package/dist/Components/Templates/MarketView.d.ts

@@ -0,0 +1 @@
+export declare const MarketView: () => import("react/jsx-runtime").JSX.Element;

package/dist/Components/Templates/TagView.d.ts

@@ -1,6 +1,7 @@
 import { Tag } from '../../types';
-export declare const TagView: ({ tag, heighlight, onClick }: {
+export declare const TagView: ({ tag, heighlight, onClick, count }: {
     tag: Tag;
     heighlight?: boolean | undefined;
     onClick?: ((e: any) => void) | undefined;
+    count?: number | undefined;
 }) => import("react/jsx-runtime").JSX.Element;

package/dist/Components/Templates/index.d.ts

@@ -5,3 +5,4 @@ export { MoonCalendar } from './MoonCalendar';
 export { SelectUser } from "./SelectUser";
 export { OverlayItemsIndexPage } from "./OverlayItemsIndexPage";
 export { AttestationForm } from "./AttestationForm";
+export { MarketView } from "./MarketView";

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export { AppShell, Content, SideBar, Sitemap } from "./Components/AppShell";
 export { AuthProvider, useAuth, LoginPage, SignupPage, RequestPasswordPage, SetNewPasswordPage } from "./Components/Auth";
 export { UserSettings, ProfileView, ProfileForm } from './Components/Profile';
 export { Quests, Modal } from './Components/Gaming';
-export { TitleCard, CardPage, MapOverlayPage, OverlayItemsIndexPage, MoonCalendar, SelectUser, AttestationForm } from './Components/Templates';
+export { TitleCard, CardPage, MapOverlayPage, OverlayItemsIndexPage, MoonCalendar, SelectUser, AttestationForm, MarketView } from './Components/Templates';
 export { TextInput, TextAreaInput, SelectBox } from './Components/Input';
 import "./index.css";
 declare global {