├── .gitmodules └── README.md /.gitmodules: -------------------------------------------------------------------------------- 1 | [submodule "apps/redex"] 2 | path = apps/redex 3 | url = git@github.com:coosto/redex.git 4 | branch = master 5 | [submodule "apps/apxr"] 6 | path = apps/apxr 7 | url = git@github.com:Rober-t/apxr.git 8 | branch = master 9 | [submodule "apps/mandelixir"] 10 | path = apps/mandelixir 11 | url = https://github.com/ericentin/mandelixir 12 | branch = master 13 | [submodule "apps/coincoin"] 14 | path = apps/coincoin 15 | url = git@github.com:robinmonjo/coincoin.git 16 | branch = master 17 | [submodule "apps/ex-mustang-slack-bot"] 18 | path = apps/ex-mustang-slack-bot 19 | url = git@github.com:techgaun/ex_mustang.git 20 | branch = master 21 | [submodule "apps/poxa-pusher-server"] 22 | path = apps/poxa-pusher-server 23 | url = git@github.com:edgurgel/poxa.git 24 | branch = master 25 | [submodule "apps/skirnir-email-server"] 26 | path = apps/skirnir-email-server 27 | url = https://github.com/altenwald/skirnir 28 | branch = master 29 | [submodule "apps/nerves-hub-web"] 30 | path = apps/nerves-hub-web 31 | url = https://github.com/nerves-hub/nerves_hub_web.git 32 | branch = master 33 | 34 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # Real World Elixir Apps 2 | 3 | > Real World Elixir apps and their open source codebases for developers to learn from 4 | 5 | Learn from Elixir apps written by experienced developers. 6 | 7 | You'll find the source code for the Real World Elixir apps in the [`apps/`](apps/) subdirectory. 8 | 9 | Thank you to every developer who has worked on a project this repo links to, your work is helping developers learn Elixir. 10 | 11 | ## How to install on your computer 12 | 13 | ```bash 14 | # Clone this git repo: 15 | git clone git@github.com:szTheory/real-world-elixir-apps.git 16 | 17 | cd real-world-elixir-apps/ 18 | 19 | # The apps are linked to as git submodules. 20 | # This will take some time... (see comment below for possible speedup) 21 | git submodule update --init 22 | 23 | # OR if you've got git 2.9+ installed try to run updates in parallel: 24 | # git submodule update --init --jobs 4 25 | ``` 26 | 27 | ## Information for Contributors 28 | 29 | ### How to add a Real World App 30 | 31 | Given a GitHub repo for an app `githubuser/foo`: 32 | 33 | ```bash 34 | # Inside the project root: 35 | git submodule add -b master git@github.com:githubuser/foo.git apps/foo 36 | ``` 37 | 38 | ### Updating the apps submodules to latest 39 | 40 | The apps in `apps/` are git submodules. Git submodules are locked to a revision and don't stay in sync with the latest revision. 41 | 42 | To update the revisions, run: 43 | 44 | ```bash 45 | # This will take some time: 46 | git submodule foreach git pull origin master 47 | ``` 48 | 49 | ## Other Real World Codebase Collections 50 | 51 | - [Real World Erlang Apps](https://github.com/szTheory/real-world-erlang-apps) 52 | - [Real World Plug](https://github.com/szTheory/real-world-plug) 53 | - [Real World Phoenix](https://github.com/szTheory/real-world-phoenix) 54 | - [Real World Absinthe](https://github.com/szTheory/real-world-absinthe) 55 | - [Real World Nerves](https://github.com/szTheory/real-world-nerves) 56 | - [Real World Rails](https://github.com/eliotsykes/real-world-rails) 57 | - [Real World Sinatra](https://github.com/jeromedalbert/real-world-sinatra) 58 | - [Real World Ruby Apps](https://github.com/jeromedalbert/real-world-ruby-apps) 59 | - [Real World React](https://github.com/jeromedalbert/real-world-react) 60 | - [Real World Ember](https://github.com/eliotsykes/real-world-ember) 61 | - Know any others? Please open a PR and add the link here 62 | 63 | --- 64 | 65 | ## Contributors 66 | 67 | - Contributions are welcome, fork the GitHub repo, make your changes, then submit your pull request! Reach out if you'd like some help. 68 | --------------------------------------------------------------------------------