iOSDK is enabling developers to buidl amazing applications on top of Newcoin in record time.
Blockchain development is hard. Managing authorization, users, content and relationships is hard. Building backends and UIs is hard. iOSDK and the Newgraph API are set to help teams reach business logic implementation sooner.
Please visit the newstack console. The alpha environment is at console-dev.newstack.dev).
You don't strictly have to register your application on Newstack to use iosdk, but this approach is going to make your life easier, if you are planning to use the powerful services the Newstack ecosystem is offering.
Use this if starting a project from scratch. This stage involves
curl https://raw.githubusercontent.com/newstackdev/iosdk/main/scripts/create.sh | bash -s <project-name>
This will generate a demo craco-based project. (craco is a layer on top of create-react-app that allows easier customization of webpack, among other things overriding lesscss variables used by ant-design styles).
Run craco start to start the demo app.
npm i @newstackdev/iosdk --save
You will likely want to use parts of the SDK in such scenario, see Usage below.
For existing condebases you might be interested in lower-level components only. This involves lower level work and Consider @newfound8ion/newcoin-sdk and/or @newstackdev/newgraph-api-client depending on your implementation plan.
Newgraph API (see below) is described as a Swagger and can be used to generate a client in any language. We welcome contributions in this space.
Following the Project Starter section under Installation above, you should by now have an installed project that shows a default landing page for the user.
Check src/index.tsx for the basic setup.
Note the single component representing a full application which you will extend as described in the following sections.
Some routes and pages are provided as part of the SDK. Add more routes and pages using the built in react-router as shown in src/index.tsx:
<App config={config}>
<Route key="hello" exact path="/hello" component={HelloIO} />
<Route key="goodbye" exact path="/goodbye" component={GoodbyeIO} />
</App>
iOSDK manages state and provides actions to interact with it and the underlying API libraries. However your use case is unique, and you will likely need to add more state, actions and effects.
Note src/overmind/app.ts. It provides an example for setting up a simple counter state. This state is included in the larger state provided by the SDK so you can add your logic on top of what's already provided:
import { Action } from "@newstackdev/iosdk/src/types";
const test : Action = (({ state, actions }) => {
// actions.custom.info();
state.app.counter++;
});
export const app = {
app: {
actions: {
test
},
state: {
counter: 0
},
effects: {}
}
};
export default app;
Check the overmind docs for namespaced to see how you can nest state and actions to implement complex use cases.
Pages are normal react components, however note that by importing:
import { useActions, useAppState } from '@newstackdev/iosdk/src/overmind';
you are getting the state with your custom actions defined in the previous section injected right into actions and state. This means no extra work needs to be done to use them immediately as in the usage of state.app.test() and state.app.counter below:
const HelloIO: NLView = () => {
const actions = useActions();
const state = useAppState();
return <>
Hello {state.api.auth.user?.username}!
<div>
<Button onClick={ () => {
actions.app.test()
}}>Count: {state.app.counter}</Button>
<Button
onClick={() => actions.routing.historyPush({ location: "/goodbye" })}>Goodbye button</Button>
</div>
</>
}
const GoodbyeIO: NLView = () => <>
Goodbye IO!
<div>
<Link to="/hello">Hello</Link>
</div>
</>
The state management part of the SDK is currently the best source of examples for using the Newgraph and Newcoin apis. We are also working on more materials to cover this space.
Newgraph is a fully serverless managed API service providing a generic backend for creative economy applications built to interact with Newcoin. By large, newgraph features:
- a REST api
- a websockets server
- firebase authentication
- an advanced filesystem-like content management system with media processing capability
- Newcoin cloud wallet (testnet phase)
- analytics and search
- data sharing and security features
These awesome underlying technologies and their dependencies are used to make the imlementation possible with reasonable effort:
| Technology | Notes | ||
|---|---|---|---|
| Language | Typescript | A Bhai-lang implementation is considered | |
| Authorization | Firebase | More is underway | |
| Component framework | React | Implementations for vue, angular, svetle and others are under consideration | |
| State management | Overmindjs | See overmindjs. | |
| Component library | Ant design | See https://ant.design/ |
There are more opensource technologies we all know and love than we can enumerate here, see package.json for an overview or follow along with the docs.
This is a very early release and should not be considered stable. We are working hard to improve this, but you've been warned.
- Early public release
- Good vibes
This project is under very active development. Submit a pull request or an issue to make it better.
MIT