mirror of
https://github.com/embarklabs/embark.git
synced 2025-01-24 20:51:55 +00:00
Michael Bradley, Jr
9829e925b4
refactor(@embark/api): catch-all route, fallback pages for Cockpit
Implement a `/*` server-side catch-all route for Cockpit that loads Cockpit's `index.html`. This change is necessary with intent to disable offline-first behavior in production builds of Cockpit. Cockpit's service worker effectively translates server-side route unavailability into client-side behaviors of connected-react-router. When the service worker is unregistered the same will be accomplished via the server-side catch-all route. Implement fallback pages for when embark is in the monorepo but Cockpit's Create React App development server isn't yet started or isn't yet responsive. Implement a fallback page for when the static build of Cockpit is missing. When embark is in the monorepo, give instructions for building Cockpit. Otherwise, report that the distribution is broken. Deprecate the environment variable `EMBARK_DEVELOPMENT` in favor of `EMBARK_UI_STATIC`. Unless the latter is truthy at runtime, when embark is in the monorepo the CRA dev server of Cockpit will be accessible at `localhost:55555` via proxied requests to `localhost:3000`. The deprecation is not a breaking change as `EMBARK_DEVELOPMENT` / `EMBARK_UI_STATIC` are not relevant to normal users, but only to developers working on embark itself. Bump `express-http-proxy` to the latest version.
What is Embark
Embark is a framework that allows you to easily develop and deploy Decentralized Applications (DApps).
A Decentralized Application is a serverless html5 application that uses one or more decentralized technologies.
Embark currently integrates with EVM blockchains (Ethereum), Decentralized Storages (IPFS), and Decentralized communication platforms (Whisper and Orbit). Swarm is supported for deployment.
With Embark you can:
Blockchain (Ethereum)
- Automatically deploy contracts and make them available in your JS code. Embark watches for changes, and if you update a contract, Embark will automatically redeploy the contracts (if needed) and the dapp.
- Contracts are available in JS with Promises.
- Do Test Driven Development with Contracts using Javascript.
- Keep track of deployed contracts; deploy only when truly needed.
- Manage different chains (e.g testnet, private net, livenet)
- Easily manage complex systems of interdependent contracts.
Decentralized Storage (IPFS, Swarm)
- Easily Store & Retrieve Data on the DApp through EmbarkJS. Including uploading and retrieving files.
- Deploy the full application to IPFS or Swarm.
- Import and deploy contracts hosted on Swarm.
Decentralized Communication (Whisper, Orbit)
- Easily send/receive messages through channels in P2P through Whisper or Orbit.
Web Technologies
- Integrate with any web technology including React, Foundation, etc..
- Use any build pipeline or tool you wish, including grunt, gulp and webpack.
$ npm -g install embark
Description
Framework for serverless Decentralized Applications using Ethereum, IPFS and other platforms
https://framework.embarklabs.io/
Languages
JavaScript
73.9%
TypeScript
14%
CSS
8%
HTML
4.1%