{"id":20569784,"url":"https://github.com/nasa-gcn/americana-stack","last_synced_at":"2025-04-14T16:36:11.597Z","repository":{"id":186979954,"uuid":"675762926","full_name":"nasa-gcn/americana-stack","owner":"nasa-gcn","description":"A Remix Stack for US Federal web sites on AWS. Includes US Web Design System, react-uswds, pre-commit hooks for linting and type checking, and continuous integration with GitHub Actions","archived":false,"fork":false,"pushed_at":"2025-04-02T17:56:56.000Z","size":355,"stargazers_count":32,"open_issues_count":10,"forks_count":2,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-04-02T18:44:28.832Z","etag":null,"topics":["government","remix-stack","uswds"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nasa-gcn.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-08-07T16:59:24.000Z","updated_at":"2025-04-02T17:56:53.000Z","dependencies_parsed_at":"2024-01-26T18:24:40.572Z","dependency_job_id":"6b1dec3d-19d3-4b50-8aa0-328d7563a93c","html_url":"https://github.com/nasa-gcn/americana-stack","commit_stats":null,"previous_names":["nasa-gcn/americana-stack"],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nasa-gcn%2Famericana-stack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nasa-gcn%2Famericana-stack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nasa-gcn%2Famericana-stack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nasa-gcn%2Famericana-stack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nasa-gcn","download_url":"https://codeload.github.com/nasa-gcn/americana-stack/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248917315,"owners_count":21182970,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["government","remix-stack","uswds"],"created_at":"2024-11-16T05:09:32.831Z","updated_at":"2025-04-14T16:36:11.574Z","avatar_url":"https://github.com/nasa-gcn.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Remix Americana Stack\n\nLearn more about [Remix Stacks](https://remix.run/stacks).\n\nTo get started, run:\n\n    npx create-remix@latest --template nasa-gcn/americana-stack\n\n## What's in the stack\n\n- Accessibility-first design system and CSS framework for United States government web sites with the [U.S. Web Design System (USWDS)](https://designsystem.digital.gov)\n- USWDS widgets for React with [trussworks/react-uswds](https://github.com/trussworks/react-uswds.git)\n- [AWS deployment](https://aws.com) with [Architect](https://arc.codes/)\n- Production-ready [DynamoDB Database](https://aws.amazon.com/dynamodb/)\n- DynamoDB access via [`arc.tables`](https://arc.codes/docs/en/reference/runtime-helpers/node.js#arc.tables)\n- Code formatting with [Prettier](https://prettier.io)\n- Linting with [ESLint](https://eslint.org)\n- Static Types with [TypeScript](https://typescriptlang.org)\n- Automated formatting, linting, and type checks on git commits with [husky](https://github.com/typicode/husky) and [lint-staged](https://github.com/okonet/lint-staged)\n\n## Development\n\nThe following command will run two processes during development when using Architect as your server.\n\n- Your Architect server sandbox\n- The Remix development server\n\n```sh\n$ npm run dev\n```\n\nYour file changes are watched, and assets are rebuilt upon change.\n\nOpen up [http://localhost:3333](http://localhost:3333) and you should be ready to go!\n\n## Deploying\n\nBefore you can deploy, you'll need to do some setup with AWS:\n\n- First [install the AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html)\n- Then [follow the Architect setup instructions](https://arc.codes/docs/en/guides/get-started/detailed-aws-setup).\n\nIf you make it through all of that, you're ready to deploy!\n\n1. build the app for production:\n\n   ```sh\n   npm run build\n   ```\n\n2. Deploy with `arc`\n\n   ```sh\n   arc deploy production\n   ```\n\nYou're in business!\n\n## Styling\n\nThere are a variety of ways to add custom CSS styling.\n\n### Theme customization - [`app/theme.scss`](https://github.com/nasa-gcn/americana-stack/blob/main/app/theme.scss)\n\nYou can customize the USWDS theme by adjusting any of the [USWDS settings](https://designsystem.digital.gov/documentation/settings/) or by adding custom [Sass](https://sass-lang.com) by editing the file [`app/theme.scss`](https://github.com/nasa-gcn/americana-stack/blob/main/app/theme.scss).\n\n### Regular style sheets - `app/**/*.css`\n\nYou can add ordinary CSS stylesheets (file extension `.css`) anywhere in the [app](https://github.com/nasa-gcn/americana-stack/blob/main/app) directory and then [link them into the route modules where you need them](https://remix.run/docs/en/main/guides/styling#regular-stylesheets).\n\n### CSS modules - `app/**/*.module.css`\n\nYou can add (file extension `.module.css`) anywhere in the [app](https://github.com/nasa-gcn/americana-stack/blob/main/app) directory and then [include them in any React component](https://remix.run/docs/en/main/guides/styling#css-modules).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnasa-gcn%2Famericana-stack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnasa-gcn%2Famericana-stack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnasa-gcn%2Famericana-stack/lists"}