Isomorphic - React Redux Admin Dashboard

Contents

1. How to setup non monorepo for Isomorphic Next.js version?

2. Laravel JWT

3. How to run Django?

4. Which project to use from isomorphic?

5. Send love to our product

6. How to use Isomorphic boilerplate single?

7. Can I get a Refund?

8. Get Quick Support

9. How to use Chat with Isomorphic?

10. Item Support Policy

11. How to change colour theme in Isomorphic?

12. Invalid token status in Isomorphic Servers?

13. window variable error on next.js template

1. How to setup non monorepo for Isomorphic Next.js version?

if you want to run the non monorepo version of isomorphic-next you need to do the following,

1. copy isomorphic-next content to your next.js app

2. copy each folder from inside the shared directory to the root of your next js app. It's better if copy the content of the container, redux and other directories that are already available on your next.js app so that you don't replace them.  put the contents [except package.json] from shared/redux and shared/containers to the containers and redux directory of your app.

3. and add the below aliasing to your next.config.js file. 

const path = require("path");
module.exports = {
    webpack(config, options) {
        config.resolve.alias = {
            ...config.resolve.alias,
            "@iso/assets": path.join(__dirname, "assets"),
            "@iso/components": path.join(__dirname, "components"),
            "@iso/config": path.join(__dirname, "config"),
            "@iso/containers": path.join(__dirname, "containers"),
            "@iso/redux": path.join(__dirname, "redux"),
            "@iso/lib": path.join(__dirname, "library"),
            "@iso/ui": path.join(__dirname, "UI"),
        };
        return config;
    },
};

4. some of the package might be missing in the package.json file since we are using monorepo so you might need to install them based on the module not found error.

2. Laravel JWT

First Check the Laravel instruction below

## Getting Started

The procedure to getting started with an isomorphic laravel starter kit. We have used Laravel default `Auth` with `auth-jwt`.

- `composer update`
- `Rename your .env.example to .env`
- `Fill your .env files database credentials [DB_DATABASE, DB_USERNAME, DB_PASSWORD]`
- `php artisan migrate`
- `sudo php artisan serve --port=9000`
Now you are good to go

If you want to create your own secret then run the below command
- `php artisan jwt:secret`

## Routes

- `Route::post('register', '[email protected]');`  //generate token
- `Route::post('login', '[email protected]');`  //generate token
- `Route::post('logout', '[email protected]');` // logout will make the token to blacklisted you have to create - token again from login route
- `Route::post('refresh', '[email protected]');` //can refresh token with existing token
- `Route::post('secret/test', '[email protected]');`


In the React code do the below change

In order to get the valid token you will have to do some code here.

you will have to make call to the /login endpoint from the signin page with user: [email protected] password: demodemo. this will give you the login token which needed to be stored in the localstorage in same key (id_token)  which will use to validate our token in the /secret/test  endpoint calling when you will click that Check auth status button.

3. How to run Django?

Currently we are working on the documentation we will try to update the documentation soon. In the meantime please follow this guide

To run it you need to first run 

yarn 

command at the root directory where you have packages, shared directory. and then run 

yarn start:iso-servers 

from the root directory. after that you client should run on localhost:3000.

Now that your client is running start the Django server from 

packages/isomorphic-servers/servers/django directory.  

basically you just need to run this command from this directory

python manage.py runserver 9000

after running your django server it should be running on localhost:9000 port 

and then go to the client app localhost:3000 and your server api for this secret/test route. 

we have integrated sercet/test api route in the Check Auth Status button. so when you click that button it should give you the auth status.

if it's still not working please send us a video how you are running the app, show us your server running port and client running port and api test from the client app and from the dev console.

4. Which project to use from isomorphic?

Which Isomorphic project to use:

we do have several implementation and deciding which one to use can be tricky.

i) the root isomorphic directory is a separate application which is a non monorepo version. you can use it directly in any project or start playing with it.

ii) the packages directory is a mono repo implementation containing separate version of isomorphic. it has  react and next js implementation as well as quick starter boilerplates for different uses.

iii) if you are comfortable with mono repo i will suggest you to use the isomorphic-boilerplate package. but if you rather not want to use mono repo than just copy out the isomorphic-boilerplate-single and start working with it.

iv) why boilerplate? because it's a minimal blank version of the whole application with the layouts. you can just use it as a regular react application. and bring the component or views that you need from the app. As boilerplate is lightweight it will be fast and will run the application in no time.

5. Send love to our product

Hope you have liked our product. Our engineering & technical support team puts great effort to create the best product in the market with continuous effort to improve it each day for our users. We will really appreciate it if you can show your appreciation for our product by sending us a 5-star rating at Envato. Good feedbacks encourage the whole team to improve the product better.  You can send us your feedback from this link https://codecanyon.net/downloads under the Download button here https://monosnap.com/file/IjKAVXsi5Ej9Xrx0zkQt9Cl1cc0R39.

6. How to use Isomorphic boilerplate single?

You should use Isomorphic boilerplate single if you want to use non monorepo boilerplate. More on this here https://redqsupport.ticksy.com/article/16233/.

To use Isomorphic boilerplate single just copy all it's content to a separate project and run this command.

1. In project root (isomorphic-boilerplate-single) run [yarn]

2. yarn start 


Now if you get error like below 

I get the following error: 

./src/containers/Sidebar/options.js Module not found: Can't resolve '@iso/config/icon.config' in '/Users/nehbatwara/Desktop/Isomorphic - React Redux Admin Dashboard/isomorphic/packages/isomorphic-boilerplate-single/src/containers/Sidebar'

Image attached as well. If I can get the resolution for this quick that would be helpful! 

2786555722.png


Just follow this steps to solve the above error

it looks like the icon.config.js file is missing in the 

isomorphic-boilerplate-single/src/config directory

you can get this file from shared/config/icon.config.js and move it to the isomorphic-boilerplate-single/src/config directory.



7. Can I get a Refund?

Unfortunately, we don't provide Refund except if you can have a detailed discussion with the support team and you can prove to them there is a bug that is stopping you from releasing or using our product. In order to consider for refund, the feature needs to be available in our product and there needs to be a genuine bug with valid proof that the bug is available. This is the only case which we may consider for a refund but it's very rare as most of the features you will use is very stable for years now and lots of users are using them on regular basis.  Also, any issue or bug that is only not working for your case but working on our site and other user's sites is not considered for a refund. A third-party plugin or theme conflict is also not considered for a refund. 


8. Get Quick Support

In order to get quick support please submit your support ticket with the issue details and below information.

  1.  which package you are using?
  2.  Are you using monorpeo or non monorepo?
  3. Have you made any changes in the code?
  4. have you updated any libraries?
  5. Which command you have run and how you have run can you send us a video?
  6. What is your node js version?
  7. Which Operating system you are using and What version?

NB: Please share a screenshot or video of your issue so that we can reproduce the issue on our end.

9. How to use Chat with Isomorphic?

How to use Chat app:

 To work with chat module you need to setup firebase and put message, channel contents in your db according to this docs https://redq.gitbooks.io/isomorphic/content/components/chat-firebase.html

just follow the firebase parts from this docs because the reference to the isormorphic are old and outdated

10. Item Support Policy

We strictly follow Envato item support policy https://themeforest.net/page/item_support_policy

you can find what's not included in the support there 

11. How to change colour theme in Isomorphic?

please go to shared/config/theme folder and change your required color within color plate in default.js file

12. Invalid token status in Isomorphic Servers?

In order to get the valid token you will have to do some code here.

you will have to make call to the /api/login endpoint from the signin page with user: [email protected] password: demodemo. this will give you the login token which needed to be stored in the localstorage in same key (id_token)  which will use to validate our token in the /api/test or /api/secret endpoint calling when you will click that Check auth status button.

13. window variable error on next.js template

So far we have found that process.browser is probably causing this as next.js made it depreciable and throws an error. we need to replace it with  

typeof window === "undefined"

so if you can replace process.browser with the above code it should fix the issue. We will run some further testing and if everything is fine we will push an update soon.