We've Rewritten our Developer Experience Portal and you’re gonna love it 🎉

Mehdi Raza
APIMATIC
Published in
3 min readAug 1, 2018

Greetings! Our Developer Experience Portal is already into its next version! We did not pack our bags after launching the first version last month, and are proud to present Developer Experience Portal Version 1.1. This time even more optimised, more beautiful, and more Developer friendly. The new version is packed with a number of improvements and some new features.

Read what makes APIMatic's Developer Experience portal different from other available solutions.

🔨 Built from Ground Up to be Awesome

The new portal is written from scratch, based on our new internal Documentation Format that powers much of the interactive parts of docs such as the console and reactive code snippets.

This will enable us to implement more complex features in the future without being limited by markup languages such as Markdown.

✍️ ️Overhaul of Typography

The design of typography (textual elements such as headings, paragraph, lists, etc) has been overhauled. The new portal brings massive improvements to the look of the content.

👨‍💻 Redesigned API Reference

Endpoint reference has been redesigned and now looks much cleaner.

Also, types are now linked to their definitions for easier navigation.

Now linking to properly to models and enumerations in parameters table.

🎚️ Switching between Languages

Switching between language maintains the endpoint or model or whatever section is open. Config in console is also persisted between languages.

We’ve added icons in the language drop-down.

🍭 Improved Embedded Mode

Menu looks better in the embedded (two-column) mode. Large menus will scroll now.

🔍 Quick Jump

We’ve added fuzzy search that helps quickly jumping to endpoints and models. It can also be triggered from the keyboard using Ctrl+K .

Using the keyboard to quickly navigate documentation.

🍃 Gentler Error Messages

We’ve improved the messaging in case an API call fails in the API console.

🏃 Faster, Lighter

The new portal is written to be fast and light. Despite adding new features, we’ve actually shed weight resulting in about 33% reduction in size.

The new portal optimizes for a perception of fast loading speed by delaying loading of non-critical components until they are needed. This results in a 71% reduction in size on first load. Technical implementation details can be read here.

⭐️ How do I get this?

--

--