esri.github.io

esri.github.io is the official GitHub landing page for Esri's open source projects, aggregating repositories by topic directly from GitHub.

What is esri.github.io?

esri.github.io is the official GitHub landing page for Esri's open source projects, aggregating repositories by topic directly from GitHub. It takes a YAML file (data/projects.yml) as its source of case studies and featured projects, and renders a simple web page that lets visitors browse Esri's open source offerings. The page runs entirely in the browser as a static site, hosted on GitHub Pages at http://esri.github.io, and is maintained by Esri.

Key Features

• GitHub topic-powered categories — The project category links and search suggestions on the page are generated from GitHub topics, so clicking a category runs a GitHub search for repositories tagged with that topic.
• Five topic filters — Visitors can filter projects by web-development, data-management, spatial-analysis, publishing-sharing, and native-development, each linking to the corresponding GitHub topic search.
• YAML-driven content — Featured projects and case studies are defined in data/projects.yml with fields for title, description, URL, display language, search language, and star count.
• Calcite and Tailwind CSS styling — The page is styled with Esri's Calcite design system and Tailwind CSS, giving it a consistent look with Esri's other web properties.
• Simple local development — After forking and cloning, the site can be served locally with npx serve; no build step is required.
• Apache 2.0 license — The repository is released under the Apache License, Version 2.0, with copyright held by Esri.
• Open contribution model — Anyone can contribute by following the contribution guidelines and code of conduct, and project data is added by editing the YAML file.

Who is it for?

• Esri open source maintainers — Use the page to showcase their projects by adding entries to projects.yml with title, URL, and description.
• Developers evaluating Esri's open source tools — Browse the landing page by topic to quickly find projects related to web development, spatial analysis, or native development.
• Contributors to Esri ecosystem projects — Can fork the repo, add new projects, and submit pull requests following the contribution guidelines.

What can you do with esri.github.io?

• Project discovery: Visitors can quickly locate Esri open source projects by clicking topic-based category links that lead to filtered GitHub searches.
• Customizing the landing page: Developers can fork the repository, edit projects.yml to add or update featured projects, and host their own version of the page.
• Learning from project metadata: Contributors can see how projects are defined (title, description, URL, display language, search language, stars) and use that pattern for their own YAML-driven landing pages.

How does esri.github.io work?

1. Fork and clone the repository.
2. Run npx serve from the terminal to start a local web server.
3. Open the browser to the URL provided by Serve.
4. The site fetches no external data at runtime; categories are static links to GitHub topic search URLs and featured projects are read from projects.yml.

FAQ

Is esri.github.io free to use?

Yes, the repository is open source under the Apache License 2.0, so anyone can freely use, modify, and distribute it with attribution.

How do I add a project to esri.github.io?

Edit data/projects.yml and add a YAML entry with a title, description, URL, display language, search language, and star count, then submit a pull request following the contributing guidelines.

How are the project categories determined?

The category badges on the page link to GitHub searches for specific topics, such as web-development, data-management, spatial-analysis, publishing-sharing, and native-development. The category set is defined by those topic links, not by an automated list.

Does esri.github.io use a build step?

No, the site is a simple web page driven by JavaScript and styled with Calcite and Tailwind CSS. You can serve it locally with npx serve without a build process.

What license is esri.github.io released under?

It is released under the Apache License, Version 2.0, as stated in the repository's LICENSE file, with copyright © 2022 Esri.