sysgears / apollo-universal-starter-kit

Apollo Universal Starter Kit is a SEO-friendly, fully-configured, modular starter application that helps developers to streamline web, server, and mobile development with cutting-edge technologies and ultimate code reuse.
https://apollokit.org
MIT License
1.68k stars 324 forks source link

Training or tutorials are needed #113

Open sakhmedbayev opened 7 years ago

sakhmedbayev commented 7 years ago

Thank you guys again for this starter kit! I know you are probably very busy working on and improving other features of this project. I want to start using it for one of my projects, but I do not understand some parts of the kit, I am still learning React and GraphQL. I wonder if you can make video tutorials which will explain how different pieces of the kit fit and work together, also, showing users how to modify the kit, adding new features. I will be glad to purchase such tutorials for a reasonable price :-).

mitjade commented 7 years ago

What helped me was going through a few tutorials on React and GraphQL and then trying to follow along using this starter kit. Maybe I can point out a few of then, depending on what you are actually interested in or have problems with.

sakhmedbayev commented 7 years ago

Thank you @mitjade. At the moment, I cannot figure out how to modify the kit so only admins can add and edit content. Only, registered users can add and edit their own comments. I know it is something that contributers are currently working on - authentication and authorization . This is my biggest struggle at the moment.

sakhmedbayev commented 7 years ago

I also really like directory layout which is shown in the docs for this kit https://github.com/kriasoft/react-starter-kit/blob/master/docs/getting-started.md

Would be nice to have something like that for this kit as well.

mitjade commented 7 years ago

@sakhmedbayev Regarding authentication and authorisation I can not be of much help, since I have not yet have to deal wit this in GraphQL context. The only resource I can point you to it GraphQL with React: The Complete Developers Guide. It has some topics at the bottom that covers some authentication stuff. It is a bit expensive, but Udemy often gives different discounts, so you should be able to get it for 10$, if you wait a bit.

I like the idea of explaining the kit with the tree structure. It is something to think about, since good documentation is always the key to any project success. But we are still in the process of actually deciding what would the best structure actually be.

sakhmedbayev commented 7 years ago

Thanks @mitjade. I think, if the tree structure will have a preliminary form for now, it is still OK. It will be still very helpful for new users to start using this kit.

GiladShoham commented 7 years ago

Hi @sakhmedbayev Regarding Authentication, I can try to help you.

Please follow this issue: https://github.com/sysgears/apollo-fullstack-starter-kit/issues/103

Meantime (because it will take some time probably), you can start to try to integrate my modules for this purpose: apollo-passportjs apollo-passport-local-strategy apollo-passportjs-react apollo-passport-mongodb-driver

Integrate an authentication mechanism is usually not so simple, so let me know if you have any questions.

mitjade commented 7 years ago

Another resource that might come in handy:

graphql-authentication-register-profile

veerjainATgmail commented 7 years ago

Hi, Awesome starter kit !. Adding a new server & client modules are intuitive. A write up on, how to add new modules will certainly help

I am trying to figure out, the knex integration. I'm assuming the server database tables are created at server/database/migrations folder when i add a new migration file for a new module, I am not seeing the tables getting created. thanks in advance, mj.

larixer commented 7 years ago

@veerjainATgmail Could you clarify what migration file do you add, with what contents and whether you run yarn migrate after this?

mitjade commented 7 years ago

@veerjainATgmail Regarding adding new modules, what part seemed unclear? Would help to hear from someone who is new to this kit, to get a better picture what to explain in more detail. Btw did you try yarn cli addmodule <module-name>? Reguarding knex integration, we are working on making it better and will add some docs there as well.

veerjainATgmail commented 7 years ago

@vlasenko I am trying to add a new module similar to Posts (Videos) with a URL and comments. Now, i tried yarn migrate.. it works. Thanks for the quick response 👍 @mitjade I didnt try yarn cli add module. Yes, knex part was not clear. (I did try to refer kenx [http://knexjs.org/] documentation.) Thanks :)