Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Upgraded docs to NF and added versioned docs with next docs #209

Merged
merged 70 commits into from
Jul 25, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
70 commits
Select commit Hold shift + click to select a range
1e377dd
update site url and favicon
JDMathew Jul 1, 2024
fba1c1f
update to use docusaurus preset
JDMathew Jul 1, 2024
224d376
remove old package lock
JDMathew Jul 2, 2024
a376152
update react for docusaurus 3
JDMathew Jul 2, 2024
7d26c56
upgrade mdx for docusaurus v3
JDMathew Jul 2, 2024
312a8a5
Add prism-react-renderer
JDMathew Jul 2, 2024
a9e9f8f
Update docusaurus-plugin-image-zoom to support docusaurus v3
JDMathew Jul 2, 2024
78cb45d
update docusaurus packages to v3
JDMathew Jul 2, 2024
5133d6f
update clsx to v2
JDMathew Jul 2, 2024
ece6416
update react-player to v2
JDMathew Jul 2, 2024
7c34ad8
update theme to use new ESM
JDMathew Jul 2, 2024
0e9363f
Added @docusaurus/types to docs
JDMathew Jul 2, 2024
ba2d56b
update docusaurus.config to ts file
JDMathew Jul 2, 2024
bdaac34
Added formidable-oss-badges
JDMathew Jul 4, 2024
b5c44f9
Add min node engine
JDMathew Jul 4, 2024
66170e3
fix form links and remove duplicate in docs
JDMathew Jul 4, 2024
3091b9f
Add note to useTextInput
JDMathew Jul 4, 2024
c0f4d66
fix import package
JDMathew Jul 4, 2024
7ac7b9e
update link
JDMathew Jul 4, 2024
4226e66
Fix <Form /> component error
JDMathew Jul 4, 2024
54ca9d9
Added required prop to useTextInput docs
JDMathew Jul 4, 2024
1a252c5
fix links
JDMathew Jul 4, 2024
5f52fb5
make sidebar hidable
JDMathew Jul 4, 2024
db358a9
update readme to docusaurus 3
JDMathew Jul 4, 2024
af0ffc2
Adding docusaurus dev deps and tsconfig
JDMathew Jul 5, 2024
939f495
Add tailwindcss and tailwind plugin to docusaurus
JDMathew Jul 5, 2024
0d0dc3f
remove docusaurus Homepage
JDMathew Jul 5, 2024
a8cb1cc
update nav bar and footer to NF branding
JDMathew Jul 5, 2024
47e395e
Add react import
JDMathew Jul 5, 2024
c689fee
Add search plugin to docs
JDMathew Jul 6, 2024
0615ff1
update theme use
JDMathew Jul 6, 2024
6fcf210
add feature images
JDMathew Jul 8, 2024
a068d5e
add background img
JDMathew Jul 8, 2024
2c8910c
add img module declaration
JDMathew Jul 8, 2024
13aa084
Add divider component
JDMathew Jul 10, 2024
b42ee9f
Add section component
JDMathew Jul 18, 2024
0ad10e5
init landing featured projects
JDMathew Jul 18, 2024
6ad76c3
updated landing featured projects
JDMathew Jul 18, 2024
2e3fb51
Added Landing Features component
JDMathew Jul 18, 2024
f8f1d63
Adding Landing Banner component
JDMathew Jul 18, 2024
5d90467
Add ama badge
JDMathew Jul 18, 2024
1dca0ce
Add landing hero
JDMathew Jul 18, 2024
9f0a891
Update landing hero
JDMathew Jul 18, 2024
d4922ea
Update tagline
JDMathew Jul 18, 2024
977055e
Add index landing images
JDMathew Jul 18, 2024
7fa57c0
Added nf link button
JDMathew Jul 18, 2024
a77333b
Added landing page
JDMathew Jul 18, 2024
57c620b
added hero-pattern to landing hero
JDMathew Jul 18, 2024
7bbdcc3
add missing packages base and navbar group
JDMathew Jul 19, 2024
bca2936
fix package names in docs
JDMathew Jul 19, 2024
ed482e8
move sidebar to .ts file
JDMathew Jul 19, 2024
5aed1d1
add sidebar packages items category
JDMathew Jul 20, 2024
f45f54e
Add package descriptions for generated index page
JDMathew Jul 23, 2024
9ad72b5
Add initial versioned docs
JDMathew Jul 23, 2024
347208f
Add version to nav bar
JDMathew Jul 24, 2024
6d42ecb
Add docs to nav bar
JDMathew Jul 24, 2024
873cc88
Added versions page
JDMathew Jul 24, 2024
37bf4f1
Fix versioned docs
JDMathew Jul 24, 2024
f74ec26
update import to fix tsc error
JDMathew Jul 24, 2024
1d5ddc5
remove unused
JDMathew Jul 24, 2024
a1befdc
fix bottomSheet type children
JDMathew Jul 24, 2024
87a31ef
exclude website from tsc:check
JDMathew Jul 24, 2024
9efeaf8
remove the need for react import
JDMathew Jul 24, 2024
b2c2cea
move docs to website folder and add full docs for versioning
JDMathew Jul 25, 2024
a26959a
remove duplicate path
JDMathew Jul 25, 2024
8e9d0af
fix focus doc error
JDMathew Jul 25, 2024
778d3a6
update path and version
JDMathew Jul 25, 2024
95d5625
update sidebar and nav bar to handle guides and checklist
JDMathew Jul 25, 2024
1196015
fix links
JDMathew Jul 25, 2024
8e51cd1
fix slug for autolinking
JDMathew Jul 25, 2024
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file removed docs/checklist/focus.gif
Binary file not shown.
Binary file removed docs/checklist/text.gif
Binary file not shown.
1 change: 1 addition & 0 deletions examples/expo/App.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@ import 'react-native-gesture-handler';

import { AMAProvider } from '@react-native-ama/core';
import { StatusBar } from 'expo-status-bar';
import React from 'react';

import { AppNavigator } from './src/AppNavigation';

Expand Down
2 changes: 1 addition & 1 deletion examples/shared/src/screens/BottomSheet.screen.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ import { FormScreen } from './Form.screen';

type TimedActionProps = {};

export const BottomSheetScreen: React.FC<TimedActionProps> = ({ children }) => {
export const BottomSheetScreen: React.FC<TimedActionProps> = () => {
const [modalVisible, setModalVisible] = useState(false);

return (
Expand Down
2 changes: 1 addition & 1 deletion examples/shared/src/screens/Form.screen.tsx
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
import { Form, TextInput } from '@react-native-ama/forms';
import { SwitchListItem, Text } from '@react-native-ama/react-native';
import { Text } from '@react-native-ama/react-native';
import * as React from 'react';
import { ScrollView, StyleSheet } from 'react-native';

Expand Down
17 changes: 17 additions & 0 deletions packages/animations/docs/animations.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
---
slug: /
title: The animations package
sidebar_position: 1
---

# Intro

The animations package `@react-native-ama/animations` offers hooks and components needed to handle accessibility within animations using react-native Animated or react-native-reanimated.

## Installation

Install the `@react-native-ama/animations` package with your favourite package manager:

```bash npm2yarn
npm install @react-native-ama/animations
```
Empty file removed packages/animations/docs/index.md
Empty file.
6 changes: 3 additions & 3 deletions packages/core/docs/core.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,14 +6,14 @@ sidebar_position: 1

# Intro

The core package `react-native-ama` offers essential hooks and components needed to create an app with accessibility in mind.
The core package `@react-native-ama/core` offers essential hooks and components needed to create an app with accessibility in mind.

## Installation

Install the `react-native-ama` package with your favourite package manager:
Install the `@react-native-ama/core` package with your favourite package manager:

```bash npm2yarn
npm install -D react-native-ama
npm install @react-native-ama/core
```

### Config File
Expand Down
17 changes: 17 additions & 0 deletions packages/extras/docs/extras.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
---
slug: /
title: The extras package
sidebar_position: 1
---

# Intro

The `@react-native-ama/extras` package offers extra accessible hooks and components which are often used when building react-native apps, such as BottomSheets and Carousels.

## Installation

Install the `@react-native-ama/extras` package with your favourite package manager:

```bash npm2yarn
npm install @react-native-ama/extras
```
8 changes: 4 additions & 4 deletions packages/forms/docs/FormField.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,20 +39,20 @@ import { Form } from 'react-native-ama';

The component extends the React Native [TouchableWithoutFeedbackProps](https://reactnative.dev/docs/touchablewithoutfeedback#props).

### `id`
### `id`

The field ID. This info is stored, with the field `ref`, inside the [<Form />](./Form) component.
The field ID. This info is stored, with the field `ref`, inside the [`<Form />`](./Form) component.

| Type | Default |
|--------|-----------|
| ------ | --------- |
| string | undefined |

### `ref`

The field reference.

| Type | Default |
|-----------------|-----------|
| --------------- | --------- |
| React.RefObject | undefined |

### `hasValidation`
Expand Down
4 changes: 2 additions & 2 deletions packages/forms/docs/forms.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
slug: /
title: The Forms package
title: The forms package
sidebar_position: 1
---

Expand All @@ -13,7 +13,7 @@ The `@react-native-ama/forms` package offers essential hooks and components need
Install the `@react-native-ama/forms` package with your favourite package manager:

```bash npm2yarn
npm install -D @react-native-ama/forms
npm install @react-native-ama/forms
```

## Usage
Expand Down
20 changes: 17 additions & 3 deletions packages/forms/docs/useTextInput.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,10 +2,16 @@

This hook can be used to create a custom TextInput with all the [accessibility improvements](#accessibility-improvements) needed.

:::note

To use `useTextInput` it must be wrapped by the `<Form>` provider component from this package.
:::

## Usage

```jsx
import { useTextInput } from 'react-native-ama';
// MyTextInput
import { useTextInput } from '@react-native-ama/forms';

const MyTextInput = () => {
const { ref, ...rest } = useTextInput({ ...requiredProps });
Expand Down Expand Up @@ -83,7 +89,7 @@ This parameter specifies the next form field to focus on when the next button is

### `id`

The field ID. This info is stored, with the field `ref`, inside the [<Form />](./Form) component.
The field ID. This info is stored, with the field `ref`, inside the [`<Form />`](./Form.md) component.

| Type | Default |
| ------ | --------- |
Expand All @@ -97,7 +103,15 @@ The ID of the next field to focus when the user taps on the `next` button of the
| ------ | --------- |
| string | undefined |

### <Required /> `hasValidation`
### `required`

This property is used to set the input as required and will display and error if a value has not been set

| Type | Default |
| ------- | --------- |
| boolean | undefined |

### `hasValidation`

This property is used to know if the input can display an error, in case of failed validation; and if so is used to:

Expand Down
17 changes: 17 additions & 0 deletions packages/lists/docs/lists.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
---
slug: /
title: The lists package
sidebar_position: 1
---

# Intro

The `@react-native-ama/lists` package offers essential hooks and components needed to create accessible lists.

## Installation

Install the `@react-native-ama/lists` package with your favourite package manager:

```bash npm2yarn
npm install @react-native-ama/lists
```
4 changes: 0 additions & 4 deletions packages/react-native/docs/index.md

This file was deleted.

17 changes: 17 additions & 0 deletions packages/react-native/docs/react-native.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
---
slug: /
title: The react-native package
sidebar_position: 1
---

# Intro

The `@react-native-ama/react-native` package offers essential hooks and components which extend the base react-native components with accessibility built in.

## Installation

Install the `@react-native-ama/react-native` package with your favourite package manager:

```bash npm2yarn
npm install @react-native-ama/react-native
```
1 change: 1 addition & 0 deletions tsconfig.json
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,7 @@
"skipLibCheck": true
},
"exclude": [
"website",
"**/**/dist",
"**/**/node_modules",
"node_modules",
Expand Down
2 changes: 1 addition & 1 deletion website/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Website

This website is built using [Docusaurus 2](https://docusaurus.io/), a modern static website generator.
This website is built using [Docusaurus 3](https://docusaurus.io/), a modern static website generator.

### Installation

Expand Down
2 changes: 1 addition & 1 deletion website/babel.config.js
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
module.exports = {
...require('../babel.base'),
presets: [require.resolve('@docusaurus/core/lib/babel/preset')],
};
File renamed without changes
File renamed without changes
File renamed without changes.
File renamed without changes.
4 changes: 2 additions & 2 deletions docs/ama/intro.md → website/docs/ama/intro.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,12 +32,12 @@ If AMA detects an accessibility issue:
- Show a banner to inform that something went wrong
- Provide a guideline link to the issue

![Example of a failed accessibility check by AMA](https://github.com/FormidableLabs/react-native-ama/blob/main/docs/ama-demo.png?raw=true)
![Example of a failed accessibility check by AMA](https://github.com/FormidableLabs/react-native-ama/blob/main/website/docs/ama/ama-demo.png?raw=true)
_Example of a failed accessibility check by AMA_

<br />

![Additional information and guideline link provided by AMA](https://github.com/FormidableLabs/react-native-ama/blob/main/docs/ama-console-error.png?raw=true)
![Additional information and guideline link provided by AMA](https://github.com/FormidableLabs/react-native-ama/blob/main/website/docs/ama-console-error.png?raw=true)
_Additional information and guideline link provided by AMA_

[^1]: The accessibility support in React Native is [not fully complete](https://github.com/facebook/react-native/projects/15).
Expand Down
File renamed without changes.
File renamed without changes.
File renamed without changes
File renamed without changes.
Original file line number Diff line number Diff line change
@@ -1,5 +1,4 @@
---
slug: /
sidebar_position: 0
---

Expand Down
3 changes: 3 additions & 0 deletions website/docs/checklist/focus.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
File renamed without changes.
File renamed without changes
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes
File renamed without changes
File renamed without changes.
File renamed without changes.
File renamed without changes
File renamed without changes.
3 changes: 3 additions & 0 deletions website/docs/checklist/text.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
Original file line number Diff line number Diff line change
@@ -1,5 +1,4 @@
---
slug: /
sidebar_position: 1
---

Expand Down
File renamed without changes.
File renamed without changes.
File renamed without changes
File renamed without changes.
File renamed without changes.
Loading
Loading