|
| 1 | +<p align="center"> |
| 2 | + <a href="https://js.ipfs.io" title="JS IPFS"> |
| 3 | + <img src="https://ipfs.io/ipfs/Qme6KJdKcp85TYbLxuLV7oQzMiLremD7HMoXLZEmgo6Rnh/js-ipfs-sticker.png" alt="IPFS in JavaScript logo" width="244" /> |
| 4 | + </a> |
| 5 | +</p> |
| 6 | + |
| 7 | +<h3 align="center"><b>IPFS Nuxt App</b></h3> |
| 8 | + |
| 9 | +<p align="center"> |
| 10 | + <b><i>Using js-ipfs in a nuxtjs project</i></b> |
| 11 | + <br /> |
| 12 | + <br /> |
| 13 | + <img src="https://raw.githubusercontent.com/jlord/forkngo/gh-pages/badges/cobalt.png" width="200"> |
| 14 | + <br> |
| 15 | + <a href="https://github.com/ipfs/js-ipfs/tree/master/docs">Explore the docs</a> |
| 16 | + · |
| 17 | + <a href="https://codesandbox.io/">View Demo</a> |
| 18 | + · |
| 19 | + <a href="https://github.com/ipfs-examples/js-ipfs-examples/issues">Report Bug</a> |
| 20 | + · |
| 21 | + <a href="https://github.com/ipfs-examples/js-ipfs-examples/issues">Request Feature/Example</a> |
| 22 | + </p> |
| 23 | + |
| 24 | +## Table of Contents |
| 25 | + |
| 26 | +- [Table of Contents](#table-of-contents) |
| 27 | +- [About The Project](#about-the-project) |
| 28 | +- [Getting Started](#getting-started) |
| 29 | + - [Pre requisites](#pre-requisites) |
| 30 | + - [Installation and Running example](#installation-and-running-example) |
| 31 | + - [Available Scripts](#available-scripts) |
| 32 | + - [Compiles and hot-reloads for development](#compiles-and-hot-reloads-for-development) |
| 33 | + - [Compiles and minifies for production](#compiles-and-minifies-for-production) |
| 34 | + - [Generate static project](#generate-static-project) |
| 35 | + - [Customize configuration](#customize-configuration) |
| 36 | +- [Usage](#usage) |
| 37 | + - [`assets`](#assets) |
| 38 | + - [`components`](#components) |
| 39 | + - [`layouts`](#layouts) |
| 40 | + - [`pages`](#pages) |
| 41 | + - [`plugins`](#plugins) |
| 42 | + - [`static`](#static) |
| 43 | + - [`store`](#store) |
| 44 | +- [Documentation](#documentation) |
| 45 | +- [Contributing](#contributing) |
| 46 | +- [Want to hack on IPFS?](#want-to-hack-on-ipfs) |
| 47 | + |
| 48 | +## About The Project |
| 49 | + |
| 50 | +- Read the [docs](https://github.com/ipfs/js-ipfs/tree/master/docs) |
| 51 | +- Look into other [examples](https://github.com/ipfs/js-ipfs/tree/master/examples) to learn how to spawn an IPFS node in Node.js and in the Browser |
| 52 | +- Consult the [Core API docs](https://github.com/ipfs/js-ipfs/tree/master/docs/core-api) to see what you can do with an IPFS node |
| 53 | +- Visit https://dweb-primer.ipfs.io to learn about IPFS and the concepts that underpin it |
| 54 | +- Head over to https://proto.school to take interactive tutorials that cover core IPFS APIs |
| 55 | +- Check out https://docs.ipfs.io for tips, how-tos and more |
| 56 | +- See https://blog.ipfs.io for news and more |
| 57 | +- Need help? Please ask 'How do I?' questions on https://discuss.ipfs.io |
| 58 | + |
| 59 | +## Getting Started |
| 60 | + |
| 61 | +### Pre requisites |
| 62 | + |
| 63 | +Make sure you have installed all of the following prerequisites on your development machine: |
| 64 | + |
| 65 | +- Git - [Download & Install Git](https://git-scm.com/downloads). OSX and Linux machines typically have this already installed. |
| 66 | +- Node.js - [Download & Install Node.js](https://nodejs.org/en/download/) and the npm package manager. |
| 67 | + |
| 68 | +### Installation and Running example |
| 69 | + |
| 70 | +```console |
| 71 | +> npm install |
| 72 | +> npm start |
| 73 | +``` |
| 74 | + |
| 75 | +Now open your browser at `http://localhost:8081` |
| 76 | + |
| 77 | +### Available Scripts |
| 78 | + |
| 79 | +In the project directory, you can run: |
| 80 | + |
| 81 | +#### Compiles and hot-reloads for development |
| 82 | + |
| 83 | +```console |
| 84 | +$ npm run dev |
| 85 | +``` |
| 86 | + |
| 87 | +#### Compiles and minifies for production |
| 88 | + |
| 89 | +```console |
| 90 | +$ npm run build |
| 91 | +$ npm run start |
| 92 | +``` |
| 93 | + |
| 94 | +#### Generate static project |
| 95 | + |
| 96 | +```console |
| 97 | +$ npm run generate |
| 98 | +``` |
| 99 | + |
| 100 | +#### Customize configuration |
| 101 | + |
| 102 | +For detailed explanation on how things work, check out the [documentation](https://nuxtjs.org). |
| 103 | + |
| 104 | +## Usage |
| 105 | + |
| 106 | +A minimal demonstration of how to use `js-ipfs` with `Nuxt`. |
| 107 | + |
| 108 | +You can create the following extra directories, some of which have special behaviors. Only `pages` is required; you can delete them if you don't want to use their functionality. |
| 109 | + |
| 110 | +### `assets` |
| 111 | + |
| 112 | +The assets directory contains your uncompiled assets such as Stylus or Sass files, images, or fonts. |
| 113 | + |
| 114 | +More information about the usage of this directory in [the documentation](https://nuxtjs.org/docs/2.x/directory-structure/assets). |
| 115 | + |
| 116 | +### `components` |
| 117 | + |
| 118 | +The components directory contains your Vue.js components. Components make up the different parts of your page and can be reused and imported into your pages, layouts and even other components. |
| 119 | + |
| 120 | +More information about the usage of this directory in [the documentation](https://nuxtjs.org/docs/2.x/directory-structure/components). |
| 121 | + |
| 122 | +### `layouts` |
| 123 | + |
| 124 | +Layouts are a great help when you want to change the look and feel of your Nuxt app, whether you want to include a sidebar or have distinct layouts for mobile and desktop. |
| 125 | + |
| 126 | +More information about the usage of this directory in [the documentation](https://nuxtjs.org/docs/2.x/directory-structure/layouts). |
| 127 | + |
| 128 | +### `pages` |
| 129 | + |
| 130 | +This directory contains your application views and routes. Nuxt will read all the `*.vue` files inside this directory and setup Vue Router automatically. |
| 131 | + |
| 132 | +More information about the usage of this directory in [the documentation](https://nuxtjs.org/docs/2.x/get-started/routing). |
| 133 | + |
| 134 | +### `plugins` |
| 135 | + |
| 136 | +The plugins directory contains JavaScript plugins that you want to run before instantiating the root Vue.js Application. This is the place to add Vue plugins and to inject functions or constants. Every time you need to use `Vue.use()`, you should create a file in `plugins/` and add its path to plugins in `nuxt.config.js`. |
| 137 | + |
| 138 | +More information about the usage of this directory in [the documentation](https://nuxtjs.org/docs/2.x/directory-structure/plugins). |
| 139 | + |
| 140 | +### `static` |
| 141 | + |
| 142 | +This directory contains your static files. Each file inside this directory is mapped to `/`. |
| 143 | + |
| 144 | +Example: `/static/robots.txt` is mapped as `/robots.txt`. |
| 145 | + |
| 146 | +More information about the usage of this directory in [the documentation](https://nuxtjs.org/docs/2.x/directory-structure/static). |
| 147 | + |
| 148 | +### `store` |
| 149 | + |
| 150 | +This directory contains your Vuex store files. Creating a file in this directory automatically activates Vuex. |
| 151 | + |
| 152 | +More information about the usage of this directory in [the documentation](https://nuxtjs.org/docs/2.x/directory-structure/store). |
| 153 | + |
| 154 | +This project was bootstrapped with [create-nuxt-app](https://nuxtjs.org/docs/2.x/get-started/installation). |
| 155 | + |
| 156 | +_For more examples, please refer to the [Documentation](#documentation)_ |
| 157 | + |
| 158 | +## Documentation |
| 159 | + |
| 160 | +- [Config](https://docs.ipfs.io/) |
| 161 | +- [Core API](https://github.com/ipfs/js-ipfs/tree/master/docs/core-api) |
| 162 | +- [Examples](https://github.com/ipfs/js-ipfs/tree/master/examples) |
| 163 | +- [Development](https://github.com/ipfs/js-ipfs/blob/master/docs/DEVELOPMENT.md) |
| 164 | + |
| 165 | +## Contributing |
| 166 | + |
| 167 | +Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are **greatly appreciated**. |
| 168 | + |
| 169 | +1. Fork the IPFS Project |
| 170 | +2. Create your Feature Branch (`git checkout -b feature/amazing-feature`) |
| 171 | +3. Commit your Changes (`git commit -a -m 'feat: add some amazing feature'`) |
| 172 | +4. Push to the Branch (`git push origin feature/amazing-feature`) |
| 173 | +5. Open a Pull Request |
| 174 | + |
| 175 | +## Want to hack on IPFS? |
| 176 | + |
| 177 | +[](https://github.com/ipfs/community/blob/master/CONTRIBUTING.md) |
| 178 | + |
| 179 | +The IPFS implementation in JavaScript needs your help! There are a few things you can do right now to help out: |
| 180 | + |
| 181 | +Read the [Code of Conduct](https://github.com/ipfs/community/blob/master/code-of-conduct.md) and [JavaScript Contributing Guidelines](https://github.com/ipfs/community/blob/master/CONTRIBUTING_JS.md). |
| 182 | + |
| 183 | +- **Check out existing issues** The [issue list](https://github.com/ipfs/js-ipfs/issues) has many that are marked as ['help wanted'](https://github.com/ipfs/js-ipfs/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3A%22help+wanted%22) or ['difficulty:easy'](https://github.com/ipfs/js-ipfs/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3Adifficulty%3Aeasy) which make great starting points for development, many of which can be tackled with no prior IPFS knowledge |
| 184 | +- **Look at the [IPFS Roadmap](https://github.com/ipfs/roadmap)** This are the high priority items being worked on right now |
| 185 | +- **Perform code reviews** More eyes will help |
| 186 | + a. speed the project along |
| 187 | + b. ensure quality, and |
| 188 | + c. reduce possible future bugs. |
| 189 | +- **Add tests**. There can never be enough tests. |
| 190 | +- **Join the [Weekly Core Implementations Call](https://github.com/ipfs/team-mgmt/issues/992)** it's where everyone discusses what's going on with IPFS and what's next |
0 commit comments