Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/VeliovGroup/flow-router

🚦 Carefully extended flow-router for Meteor
https://github.com/VeliovGroup/flow-router

flow-router javascript meteor meteor-package meteorjs routing

Last synced: about 2 months ago
JSON representation

🚦 Carefully extended flow-router for Meteor

Lists

README 

        
[![support](https://img.shields.io/badge/support-GitHub-white)](https://github.com/sponsors/dr-dimitru)

[![support](https://img.shields.io/badge/support-PayPal-white)](https://paypal.me/veliovgroup)



  




# FlowRouter Extra



Carefully extended `flow-router` package. FlowRouter is a very simple router for [Meteor.js](https://docs.meteor.com/?utm_source=dr.dimitru&utm_medium=online&utm_campaign=Q2-2022-Ambassadors). It does routing for client-side apps and compatible with React, Vue, Svelte, and Blaze.



It exposes a great API for changing the URL and getting data from the URL. However, inside the router, it's not reactive. Most importantly, FlowRouter is designed with performance in mind and it focuses on what it does best: __routing__.



## Features:



- 📦 Not dependent on Blaze, ready for [__React.js__](https://github.com/veliovgroup/flow-router/blob/master/docs/react.md) and other templating/components engines/libs;

- 📦 No `underscore` package dependency;

- 👨‍💻 TypeScript definition [`types.d.ts`](https://github.com/veliovgroup/flow-router/blob/master/types.d.ts)

- 👨‍🔬 Great [tests coverage](https://github.com/veliovgroup/flow-router/tree/master/test);

- 🥑 Up-to-date [dependencies](https://github.com/veliovgroup/flow-router/blob/master/package.js);

- 📦 Support of [Fast Render](https://github.com/veliovgroup/flow-router/blob/master/docs/fast-render-integration.md) and [other great packages](https://github.com/veliovgroup/flow-router#related-packages);

- 📋 Following semver with regular [releases](https://github.com/veliovgroup/flow-router/releases);

- 📋 Great [wiki](https://github.com/veliovgroup/flow-router/wiki);

- 📋 Great [quick start tutorial](https://github.com/veliovgroup/flow-router/blob/master/docs/quick-start.md).



## Install



```shell

meteor add ostrio:flow-router-extra

```



### ES6 Import



```js

import { FlowRouter } from 'meteor/ostrio:flow-router-extra';

// Full list of available classes and instances:

// { FlowRouter, Router, Route, Group, Triggers, BlazeRenderer, RouterHelpers }

```



### Usage



```js

import { FlowRouter } from 'meteor/ostrio:flow-router-extra';



// DISABLE QUERY STRING COMPATIBILITY

// WITH OLDER FlowRouter AND Meteor RELEASES

FlowRouter.decodeQueryParamsOnce = true;



FlowRouter.route('/', {

  name: 'index',

  action() {

    // Render a template using Blaze

    this.render('templateName');



    // Can be used with BlazeLayout,

    // and ReactLayout for React-based apps

  }

});



// Create 404 route (catch-all)

FlowRouter.route('*', {

  action() {

    // Show 404 error page using Blaze

    this.render('notFound');



    // Can be used with BlazeLayout,

    // and ReactLayout for React-based apps

  }

});

```



## Documentation



- Continue with our [wiki](https://github.com/veliovgroup/flow-router/wiki);

- [Quick start](https://github.com/veliovgroup/flow-router/blob/master/docs/quick-start.md) tutorial;

- All docs as [single document](https://github.com/veliovgroup/flow-router/blob/master/docs/full.md).



### Related packages:



- [`ostrio:flow-router-title`](https://github.com/veliovgroup/Meteor-flow-router-title) - Reactive page title (`document.title`)

- [`ostrio:flow-router-meta`](https://github.com/veliovgroup/Meteor-flow-router-meta) - Per route `meta` tags, `script` and `link` (CSS), set per-route stylesheets and scripts

- [`communitypackages:fast-render`](https://github.com/Meteor-Community-Packages/meteor-fast-render) - Fast Render can improve the initial load time of your app, giving you 2-10 times faster initial page loads. [`fast-render` integration tutorial](https://github.com/veliovgroup/flow-router/blob/master/docs/fast-render-integration.md)

- [`communitypackages:inject-data`](https://github.com/Meteor-Community-Packages/meteor-inject-data) - This is the package used by `fast-render` to push data to the client with the initial HTML

- [`flean:flow-router-autoscroll`](https://github.com/flean/flow-router-autoscroll) - Autoscroll for Flow Router

- [`mealsunite:flow-routing-extra`](https://github.com/MealsUnite/flow-routing) - Add-on for User Accounts

- [`nxcong:flow-routing`](https://github.com/cafe4it/flow-routing) - Add-on for User Accounts (alternative)

- [`forwarder:autoform-wizard-flow-router-extra`](https://atmospherejs.com/forwarder/autoform-wizard-flow-router-extra) - Flow Router bindings for AutoForm Wizard

- [`nicolaslopezj:router-layer`](https://github.com/nicolaslopezj/meteor-router-layer) - Helps package authors to support multiple routers

- [`krishaamer:flow-router-breadcrumb`](https://github.com/krishaamer/flow-router-breadcrumb) - Easy way to add a breadcrumb with enough flexibility to your project (`flow-router-extra` edition)

- [`krishaamer:body-class`](https://github.com/krishaamer/body-class) - Easily scope CSS by automatically adding the current template and layout names as classes on the body element



## Running Tests



1. Clone this package

2. In Terminal (*Console*) go to directory where package is cloned

3. Then run:



### Meteor/Tinytest



```shell

# Default

meteor test-packages ./



# With custom port

meteor test-packages ./ --port 8888



# With local MongoDB and custom port

MONGO_URL="mongodb://127.0.0.1:27017/flow-router-tests" meteor test-packages ./ --port 8888

```



## Support this project:



- [Sponsor via GitHub](https://github.com/sponsors/dr-dimitru)

- [Support via PayPal](https://paypal.me/veliovgroup) — support my open source contributions once or on regular basis

- Use [ostr.io](https://ostr.io) — [Monitoring](https://snmp-monitoring.com), [Analytics](https://ostr.io/info/web-analytics), [WebSec](https://domain-protection.info), [Web-CRON](https://web-cron.info) and [Pre-rendering](https://prerendering.com) for a website