mapcn-react-native

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

mapcn-react-native

★ 57 Open GitHub ↗

Beautiful maps, made simple.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1>mapcn-rn</h1>
  <p><strong>shadcn-style, copy-owned spatial UI primitives for React Native.</strong></p>

<p>
    <a href="https://mapcn-rn.dev/">Docs</a> •
    <a href="https://mapcn-rn.dev/docs/installation">Installation</a>
  </p>
</div>

---

## Layout

```
apps/
  demo-maplibre/   Expo app — canonical MapLibre component source + examples
  demo-mapbox/     Expo app — canonical Mapbox component source + examples
  docs/            Next.js docs site (mapcn-rn.dev), serves the component registry
packages/
  cli/             the `mapcn-rn` CLI (npx mapcn-rn ...)
  shared/          renderer-independent source: types, geo/scale/color utils,
                   high-level components — materialized into both demo apps
  registry/        registry manifest + sync/check tooling
```

Component source is edited in `apps/demo-maplibre` and `apps/demo-mapbox` (or
`packages/shared` for renderer-independent pieces) and synchronized into the
CLI's registry — see `packages/registry` once the sync tooling lands.

## Development

```bash
pnpm install
pnpm --filter demo-maplibre start
pnpm --filter demo-mapbox start
pnpm --filter docs dev
pnpm --filter mapcn-rn dev   # CLI, package name "mapcn-rn"
```

`pnpm lint` / `pnpm typecheck` / `pnpm test` run across every workspace
package. `pnpm registry:sync` materializes `packages/shared` into both demo
apps and regenerates the registry under `apps/docs/public/r`;
`pnpm registry:check` fails if either is stale.

## Component layout

Components live at `components/ui/mapcn/` — in `packages/shared`, in both demo
apps, and in a consumer's project — so relative imports resolve identically
everywhere. A generated `index.ts` re-exports the installed set, making
`@/components/ui/mapcn` the single import path.

## Basemap options

One `Map` component, configured by a renderer + basemap-provider choice at
`init` time:

- **MapLibre + CARTO** (default) — no API key
- **MapLibre + MapTiler** — `EXPO_PUBLIC_MAPTILER_API_KEY`
- **MapLibre + custom** — your own style URL or style object
- **Mapbox** — `EXPO_PUBLIC_MAPBOX_TOKEN` + `MAPBOX_DOWNLOADS_TOKEN`

Switch later with `mapcn-rn provider <target>`.

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add some amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request

#### Inspired by [mapcn](https://mapcn.dev)

## License

MIT License - see the [LICENSE](LICENSE) file for details.

mapcn-react-native

Today's picks

Was this content helpful?

Recent Feedback

mapcn-react-native

Today's picks

Was this content helpful?

Recent Feedback

Download README